用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 会被强制归一volume 始终返回 1),无法通过 JS 修改muted 属性经常比 volume=0 更可靠自动播放策略中,“静音”是唯一被几乎所有浏览器允许的例外。把 muted 设为 true,就能绕过用户手势限制直接调用 play()。
muted 是布尔值,设 media.muted = true 即可,无需配 volume
volume=0 仍可能被拦截,而 muted 是明确豁免项muted = false,再调 play() ——但此时必须已有用户交互,否则仍失败muted 属性:,再配合 JS 动态解静音muted、user gesture、Promise catch 这三件事串起来处理。