0

0

使用HTML5 Video API在Web页面中获取视频播放时长

霞舞

霞舞

发布时间:2025-11-16 12:28:54

|

442人浏览过

|

来源于php中文网

原创

使用HTML5 Video API在Web页面中获取视频播放时长

本教程详细介绍了如何在web页面中利用html5

在现代Web开发中,经常需要在页面上嵌入视频并显示其相关信息,其中视频的播放时长是一个常见的需求。虽然我们可以在HTML中简单地使用

核心概念:视频时长与加载事件

HTML5的

为了确保在 duration 属性可用时进行访问,我们需要监听视频元素的特定事件。最常用的事件是 loadedmetadata 和 loadeddata:

  • loadedmetadata: 当视频的元数据(包括时长、尺寸、文本轨道等)加载完毕时触发。这是获取视频时长的理想时机,因为它发生在视频数据开始加载之前,效率更高。
  • loadeddata: 当视频的第一帧数据加载完成,并且可以开始播放时触发。这个事件比 loadedmetadata 稍晚,但同样可以用来获取时长。

通常,为了尽快获取时长信息,推荐使用 loadedmetadata 事件。

立即学习前端免费学习笔记(深入)”;

HTML结构:嵌入视频并准备显示区域

首先,我们需要一个HTML结构来嵌入视频并提供一个区域来显示视频时长。给视频元素一个 id 便于JavaScript访问,同时添加一个

标签来承载时长信息。




    
    
    获取视频播放时长
    


    

视频播放时长示例

视频时长:加载中...

小蓝本
小蓝本

ToB智能销售增长平台

下载

在上述HTML中:

  • :这个 元素将用于显示获取到的视频时长。

JavaScript实现:监听事件并获取时长

现在,我们需要编写JavaScript代码来监听 myVideo 元素的 loadedmetadata 事件,并在事件触发时获取 duration 属性的值,然后将其显示在 durationDisplay 元素中。

为了更好的用户体验,通常会将时长(以秒为单位)转换为更易读的格式,如“分钟:秒”或“小时:分钟:秒”。

// app.js
document.addEventListener('DOMContentLoaded', function() {
    const videoElement = document.getElementById('myVideo');
    const durationDisplay = document.getElementById('durationDisplay');

    // 辅助函数:将秒数格式化为 MM:SS 或 HH:MM:SS 格式
    function formatDuration(seconds) {
        const hours = Math.floor(seconds / 3600);
        const minutes = Math.floor((seconds % 3600) / 60);
        const remainingSeconds = Math.floor(seconds % 60);

        const formattedMinutes = String(minutes).padStart(2, '0');
        const formattedSeconds = String(remainingSeconds).padStart(2, '0');

        if (hours > 0) {
            const formattedHours = String(hours).padStart(2, '0');
            return `${formattedHours}:${formattedMinutes}:${formattedSeconds}`;
        } else {
            return `${formattedMinutes}:${formattedSeconds}`;
        }
    }

    // 监听 loadedmetadata 事件
    videoElement.addEventListener('loadedmetadata', function() {
        if (videoElement.duration && !isNaN(videoElement.duration)) {
            const durationInSeconds = videoElement.duration;
            durationDisplay.textContent = formatDuration(durationInSeconds);
            console.log("视频时长 (秒):", durationInSeconds);
            console.log("视频时长 (格式化):", formatDuration(durationInSeconds));
        } else {
            durationDisplay.textContent = '无法获取时长';
            console.warn('视频元数据加载完成,但时长属性不可用。');
        }
    });

    // 错误处理:如果视频加载失败
    videoElement.addEventListener('error', function() {
        durationDisplay.textContent = '视频加载失败';
        console.error('视频加载失败,请检查链接或文件。');
    });

    // 如果视频已经加载了元数据(例如,页面缓存),则立即尝试获取时长
    // 检查 readyState 是否已达到 HAVE_METADATA (2) 或更高
    if (videoElement.readyState >= 2) { 
        if (videoElement.duration && !isNaN(videoElement.duration)) {
            const durationInSeconds = videoElement.duration;
            durationDisplay.textContent = formatDuration(durationInSeconds);
            console.log("视频时长 (秒,DOM加载时已可用):", durationInSeconds);
        } else {
            durationDisplay.textContent = '无法获取时长';
            console.warn('DOM加载时视频元数据已就绪,但时长属性不可用。');
        }
    }
});

在上述JavaScript代码中:

  1. DOMContentLoaded: 确保在DOM完全加载后再执行脚本,避免元素未找到的问题。
  2. formatDuration 函数: 这是一个辅助函数,用于将原始的秒数转换为 MM:SS 或 HH:MM:SS 格式,提高了可读性。
  3. videoElement.addEventListener('loadedmetadata', ...): 这是核心部分,当视频的元数据加载完成后,回调函数会被执行。
  4. videoElement.duration: 在回调函数内部,我们访问 videoElement.duration 来获取视频总时长。
  5. isNaN(videoElement.duration): 检查 duration 是否为有效数字,因为在某些情况下(如视频未完全加载或发生错误),它可能返回 NaN 或 Infinity。
  6. durationDisplay.textContent = ...: 将格式化后的时长更新到页面上的 元素中。
  7. 错误处理: 添加 error 事件监听器,以便在视频加载失败时向用户提供反馈。
  8. readyState 检查: 在 DOMContentLoaded 时,检查 videoElement.readyState。如果视频的元数据已经加载(readyState >= 2,即 HTMLMediaElement.HAVE_METADATA),则可以直接获取时长,这对于页面缓存或快速加载的场景很有用,避免了等待事件的延迟。

完整示例

将上述HTML和JavaScript代码分别保存为 index.html 和 app.js,并确保 app.js 文件通过 标签在 index.html 中正确引用。打开 index.html,您将看到视频播放器及其下方显示的视频时长。

注意事项

  • 跨域问题: 如果视频文件与您的网页不在同一个域下,可能会遇到跨域(CORS)问题。在这种情况下,浏览器可能无法加载视频或其元数据。确保视频服务器配置了正确的CORS头。
  • 视频格式支持: 确保您提供的视频格式(如MP4)被主流浏览器广泛支持。否则,视频可能无法播放,也无法获取时长。
  • 网络状况: 视频时长依赖于视频元数据的加载。在网络状况不佳时,获取时长可能会有延迟。
  • preload 属性: preload="metadata" 可以帮助浏览器更快地获取时长,但它只是一个提示,浏览器不一定会严格遵守。如果设置为 none,则需要用户交互(如点击播放)才能加载元数据。
  • 精度: duration 属性返回的时长通常是浮点数,表示秒数,精度可能因视频编码而异。在显示时进行四舍五入或格式化是良好的实践。

总结

通过利用HTML5

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

552

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

374

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

730

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

475

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

394

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

990

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

656

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

551

2023.09.20

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.1万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号