0

0

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

星夢妙者

星夢妙者

发布时间:2025-12-30 20:28:31

|

340人浏览过

|

来源于php中文网

原创

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

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

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 的读写受限明显:

PicWish
PicWish

推荐!专业的AI抠图修图,支持格式转化

下载
  • iOS Safari 下,未播放过的 audio 元素,duration 常为 NaN,需先调用 load() 或触发一次 play()(哪怕立刻 pause()
  • 微信内置浏览器对 timeupdate 频率做降频处理,有时几秒才触发一次
  • 部分安卓机在后台标签页中,timeupdate 会停止触发,即使音频仍在播放
实际项目中,不要依赖 currentTime 做高精度同步(比如歌词滚动),应优先用服务端时间戳 + 播放起始偏移来校准。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

279

2023.10.25

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

3

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.15

Java音频处理教程汇总
Java音频处理教程汇总

本专题整合了java音频处理教程大全,阅读专题下面的文章了解更多详细内容。

7

2026.01.15

windows查看wifi密码教程大全
windows查看wifi密码教程大全

本专题整合了windows查看wifi密码教程大全,阅读专题下面的文章了解更多详细内容。

30

2026.01.15

浏览器缓存清理方法汇总
浏览器缓存清理方法汇总

本专题整合了浏览器缓存清理教程汇总,阅读专题下面的文章了解更多详细内容。

2

2026.01.15

ps图片相关教程汇总
ps图片相关教程汇总

本专题整合了ps图片设置相关教程合集,阅读专题下面的文章了解更多详细内容。

8

2026.01.15

ppt一键生成相关合集
ppt一键生成相关合集

本专题整合了ppt一键生成相关教程汇总,阅读专题下面的的文章了解更多详细内容。

3

2026.01.15

热门下载

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

精品课程

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

共46课时 | 2.9万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.6万人学习

CSS教程
CSS教程

共754课时 | 19.2万人学习

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

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