video.playbackRate需在loadedmetadata/canplay事件后设置,否则无效;合法值范围因浏览器而异,iOS仅支持0.5/1.0/1.5/2.0,设错会自动修正;须校验并同步UI,且首次播放须由用户手势触发。

video 元素的 playbackRate 属性可以直接设置,但必须在 ready 状态后操作
直接写 video.playbackRate = 2.0 很可能无效——因为元素还没加载元数据或未进入 loadedmetadata / canplay 状态。浏览器会静默忽略,也不报错。
常见错误现象:页面一加载就设速率,结果播放时仍是 1.0;或者在 onload 里设,但 onload 不适用于 。
- 正确时机:监听
loadedmetadata或canplay事件后再赋值 - 也可以在用户点击播放后(如
play()的then()回调里)设置,更稳妥 - 部分安卓 WebView 或旧版 iOS Safari 对非 1.0 值支持不全,需降级 fallback
设置 playbackRate 后立即生效,但需注意浏览器限制范围
大多数现代浏览器允许的合法值是 0.0625 到 16.0(Chrome、Firefox、Edge),但实际可用区间可能更窄:
- iOS Safari 仅支持
0.5、1.0、1.5、2.0四档(硬编码限制,设其他值会自动取最近有效值) - 部分 Android 原生浏览器只接受
0.5–2.0且步进为 0.5 - 设为
0会暂停(不是“静音”),设负数无效(不会倒放)
建议始终用 Math.min(Math.max(rate, 0.5), 2.0) 做客户端校验,再赋值。
立即学习“前端免费学习笔记(深入)”;
用 JS 动态控制 playbackRate 时,要同步更新 UI 并处理异常
用户点“1.5×”按钮后,不能只改属性值,否则下次再点可能误叠加。需明确读取当前值并按需切换,同时捕获无效赋值。
const video = document.querySelector('video');
const speedBtn = document.getElementById('speed-btn');
speedBtn.addEventListener('click', () => {
const current = video.playbackRate;
let next = 1.0;
if (current === 1.0) next = 1.5;
else if (current === 1.5) next = 2.0;
else next = 1.0;
// 设置前先校验是否被浏览器接受
video.playbackRate = next;
// 主动读回确认(某些环境设完不立即更新 property)
if (Math.abs(video.playbackRate - next) > 0.01) {
console.warn(playbackRate 被浏览器修正为 ${video.playbackRate});
}
});
autoplay + playbackRate 组合在移动端大概率失效
iOS 和多数安卓浏览器禁止自动播放带声音的视频,即使加了 muted,若后续通过 JS 解除静音或修改 playbackRate,也可能触发策略拦截导致播放中断。
- 不要依赖
autoplay+playbackRate自动启播 - 首次播放必须由用户手势(click/tap)触发,之后才能安全调
play()并设速率 - 如果想“默认 1.5×”,应在用户第一次点击播放后立即设,而不是在
autoplay属性上做文章
真正容易被忽略的是:playbackRate 的变更本身不是可撤销的操作,它会持续影响后续所有 play() 调用,直到你再次显式重置——哪怕视频已暂停或 src 已更换。










