移动端video.duration不准的根本原因是元数据未加载完成,应监听loadedmetadata事件获取准确值;需过滤NaN/Infinity,iOS需用户手势触发,强依赖场景建议服务端预存时长并校验。

移动端视频播放时,duration 属性获取不到准确总时长,是常见问题。根本原因是:视频未加载完成(readyState )或未触发元数据就绪事件,此时 <code>duration 可能为 NaN、Infinity 或不准确值(如 0 或临时估算值)。
监听 loadedmetadata 事件再读取
这是最可靠的方式——只有元数据(包括时长、尺寸等)加载完成后,duration 才真正可用:
- 给
<video></video>元素绑定loadedmetadata事件,而非在DOMContentLoaded或play时直接读取 - 注意:该事件只触发一次,且可能在
canplay或canplaythrough之前发生 - 示例代码:
const video = document.getElementById('myVideo');
video.addEventListener('loadedmetadata', () => {
console.log('视频总时长(秒):', video.duration); // 此时才可信
});
处理 duration 为 NaN 或 Infinity 的情况
某些格式(如 HLS、DASH)或未设置 duration 的流媒体,在移动端常返回 Infinity;部分 MP4 若 moov box 在末尾,也可能导致初始 duration 不可读:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 检查并过滤异常值:
if (isFinite(video.duration) && video.duration > 0) - 若为
Infinity,说明是直播流或无明确结束的流,应禁用进度条拖动,并显示“直播中”等提示 - 若长期为
NaN,可能是资源加载失败或跨域限制(检查控制台 CORS 报错)
兼容 iOS Safari 的特别注意事项
iOS Safari 对自动获取元数据更保守,尤其在非用户手势触发的播放场景下:
- 必须由用户真实交互(如点击、触摸)触发
play(),才能保证后续loadedmetadata正常触发 - 避免静音自动播放后立即读
duration——即使加了muted和autoplay,iOS 仍可能延迟加载元数据 - 可配合
video.readyState判断:等于1(HAVE_METADATA)时,duration已可用
备用方案:从服务端或文件头预先获取时长
对强依赖精确时长的场景(如进度预加载、广告插入),建议服务端返回视频元信息:
- 上传视频时解析 MP4 的
moovbox,提取duration并存入数据库 - 前端请求视频资源前,先查接口拿到
{ duration: 128.5 },作为兜底值 - 客户端仍监听
loadedmetadata做校验,两者不一致时以客户端为准(防服务端缓存过期)

















