用play()和pause()控制媒体需在用户手势(如点击)中调用,play()返回Promise须.catch()捕获错误;监听play、pause、ended、error等事件而非轮询;currentTime和volume有取值限制;muted=true可绕过自动播放限制。

怎么用 play() 和 pause() 控制媒体播放
HTML5 的 和 元素原生支持 JavaScript 控制,核心就是调用 play() 和 pause() 方法。但注意:现代浏览器普遍要求用户手势(如点击)触发首次播放,否则会静默失败。
- 直接调用
play()但没用户交互?控制台大概率报错DOMException: play() failed because the user didn't interact with the document first - 推荐在按钮点击事件里调用:
document.getElementById('playBtn').addEventListener('click', () => { const media = document.getElementById('myVideo'); media.play().catch(e => console.warn('自动播放被阻止:', e)); }); -
play()返回 Promise,务必加.catch()捕获拒绝,否则错误会被吞掉
如何监听播放状态变化和错误
靠轮询或定时器查 paused、ended 等属性是低效且不可靠的。应该用事件监听——尤其是 play、pause、ended、error 这几个关键事件。
-
timeupdate事件每帧触发(约每 200–250ms),适合更新进度条,但别在里面做重操作 -
loadedmetadata触发后才能安全读取duration或设置currentTime -
error事件只在加载失败时触发(如 404、跨域、格式不支持),不会捕获解码失败等运行时错误 - 示例:监听播放完成
const video = document.getElementById('myVideo'); video.addEventListener('ended', () => { console.log('视频播完了'); // 可以自动跳转、重置、或触发下一个动作 });
怎样精确控制播放位置和音量
currentTime 和 volume 是最常改的两个属性,但它们有隐含约束:
-
currentTime单位是秒,可读可写;设为负数或超长值会被自动截断(如设成9999,实际变成duration) - 设
currentTime后立即调用play()不一定生效——需等seeking结束后才真正就位,可用seeked事件确认 -
volume范围是0.0(静音)到1.0(最大),设为1.5会被强制归一 - 移动端 iOS Safari 默认禁用音量控制(
volume始终返回1),无法通过 JS 修改
为什么 muted 属性经常比 volume=0 更可靠
自动播放策略中,“静音”是唯一被几乎所有浏览器允许的例外。把 muted 设为 true,就能绕过用户手势限制直接调用 play()。
立即学习“Java免费学习笔记(深入)”;
-
muted是布尔值,设media.muted = true即可,无需配volume - 某些安卓 WebView 或旧版 Chrome 中,仅设
volume=0仍可能被拦截,而muted是明确豁免项 - 如果后续需要恢复声音,先设
muted = false,再调play()——但此时必须已有用户交互,否则仍失败 - HTML 上建议默认加上
muted属性:,再配合 JS 动态解静音
muted、user gesture、Promise catch 这三件事串起来处理。











