信息发布→ 登录 注册 退出

html5audio标签播放进度怎么获取_currentTime属性用法说明【教程】

发布时间:2025-12-30

点击量:
audio.currentTime 返回秒数而非百分比,需用 (currentTime / duration) * 100 换算;须在 loadedmetadata 后获取 duration,监听 timeupdate 事件实时更新进度,设置 currentTime 可能触发 waiting,移动端兼容性差需特别处理。

audio.currentTime 返回的是秒数,不是百分比

获取播放进度最直接的方式是读取 currentTime 属性,但它返回的是当前已播放的**秒数(number 类型)**,不是 0–100 的百分比。你需要手动换算:

const audio = document.querySelector('audio');
const percent = (audio.currentTime / audio.duration) * 100;
注意:只有在 loadedmetadata 事件触发后,duration 才可靠;否则可能为 NaNInfinity

监听 timeupdate 事件才能实时获取进度

currentTime 是只读属性,不能靠轮询定时器去查——既低效又不准。正确做法是监听 timeupdate 事件:

audio.addEventListener('timeupdate', () => {
  console.log('当前时间:', audio.currentTime);
});
该事件在播放过程中自动高频触发(通常每 200–250ms 一次),但**不会在静音、暂停或加载中触发**。如果需要更精细控制(比如拖动进度条时同步显示),要额外监听 seekingseeked

设置 currentTime 可能触发加载和等待

currentTime 赋值会触发跳转,但行为取决于资源加载状态:

  • 若目标位置已缓冲,跳转几乎立即生效
  • 若未缓冲,浏览器会触发 waiting 事件,然后等数据加载完成才继续播放
  • 某些移动端浏览器(如 iOS Safari)在未用户手势触发的上下文中禁止自动 seek,会静默失败
建议配合 canplaycanplaythrough 使用,并捕获 error 事件:
audio.currentTime = 30;
audio.onseeked = () => console.log('跳转完成');
audio.onerror = () => console.error('跳转失败,可能未就绪或跨域限制');

移动端兼容性差的几个典型表现

在 iOS 和部分安卓 WebView 中,currentTime 的读写受限明显:

  • iOS Safari 下,未播放过的 audio 元素,duration 常为 NaN,需先调用 load() 或触发一次 play()(哪怕立刻 pause()
  • 微信内置浏览器对 timeupdate 频率做降频处理,有时几秒才触发一次
  • 部分安卓机在后台标签页中,timeupdate 会停止触发,即使音频仍在播放
实际项目中,不要依赖 currentTime 做高精度同步(比如歌词滚动),应优先用服务端时间戳 + 播放起始偏移来校准。
标签:# 事件  # 则可  # 能为  # 而非  # 拖动  # 又不  # 会在  # 几个  # 加载  # 的是  # 跳转  # webview  # html  # number  # Error  # 跨域  # ios  # ai  # safari  # 安卓  # 浏览器  # 微信  # html5  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!