video.playbackrate属性需在loadedmetadata事件后设置才有效,直接赋值如video.playbackrate = 1.5;setattribute无效因它操作html属性而非dom属性;ios safari存在倍速限制,需检测生效与否并降级处理;持久化应使用localstorage配合parsefloat读取。

video 元素的 playbackRate 属性怎么设
直接改 playbackRate 是最常用也最可靠的方式,它控制当前视频的播放速度倍数,默认是 1.0(正常速度)。这个属性可读可写,且大部分现代浏览器都支持。
注意:它必须在视频已加载元数据(loadedmetadata)之后设置才有效,否则可能被忽略或抛错。常见错误是 DOM 加载完就立刻设,但视频还没准备好。
- 设为
2.0:两倍速播放 - 设为
0.5:半速播放(慢放) - 设为
-1.0:部分浏览器支持倒放,但兼容性差,不建议依赖 - 设为
0:暂停,但不是标准用法,应优先用pause()
示例:
const video = document.querySelector('video');
video.addEventListener('loadedmetadata', () => {
video.playbackRate = 1.5;
});
为什么 setAttribute('playbackrate', '1.5') 不生效
setAttribute 操作的是 HTML 属性(attribute),而 playbackRate 是 DOM 元素的 JS 属性(property),二者不互通。HTML 中没有 playbackrate 这个合法属性,写上去也不会触发任何行为。
常见误写:video.setAttribute('playbackrate', '1.5') 或 <video playbackrate="1.5"></video> —— 这两种写法完全无效,浏览器会静默忽略。
- 正确做法永远是操作 JS 属性:
video.playbackRate = 1.5 - 如果想初始化就设速,可在
loadedmetadata后立即赋值,或监听canplay事件 - 动态切换时,无需重新 load 视频,直接改
playbackRate即可(即使正在播放)
移动端 iOS Safari 的倍速限制怎么绕
iOS Safari(尤其是 iOS 15 及更早)默认禁用非原生控件的倍速调节,即使你写了 video.playbackRate = 2.0,实际仍卡在 1.0,且不报错、不触发异常——这是最隐蔽的坑。
根本原因:iOS 对 <video></video> 的硬件解码策略限制了非标准倍速,仅允许通过原生控制栏(controls)调出的倍速菜单使用(如 0.5x/1.0x/1.5x/2.0x)。
- 若必须自定义控件,可尝试加
webkit-playsinline和playsinline属性,并确保视频未进入全屏模式 - 部分机型需用户手动开启「网站可更改播放速率」选项(设置 > Safari > 高级 > 实验性功能),但无法前端控制
- 无完美绕过方案;生产环境建议降级处理:检测
video.playbackRate设置后是否真正生效(对比读回值),不生效则隐藏倍速按钮或提示“仅支持原生控制”
如何让倍速设置在刷新后保留
倍速不是视频固有属性,刷新页面就会重置。要持久化,得靠客户端存储,推荐用 localStorage 记录用户上次选的值。
关键点在于时机:不能在 DOMContentLoaded 就读取并设值,因为视频可能还没 ready;也不能在 play 事件里设,容易和自动播放逻辑冲突。
- 最佳时机仍是
loadedmetadata:此时能安全读写playbackRate,也适合从localStorage拿值 - 每次修改后立即存:比如用户点“1.8x”,立刻执行
localStorage.setItem('videoSpeed', '1.8') - 注意类型:存字符串,取出来要
parseFloat(),否则'1.5' === 1.5为 false,赋值会失败
示例:
video.addEventListener('loadedmetadata', () => {
const saved = localStorage.getItem('videoSpeed');
if (saved) video.playbackRate = parseFloat(saved);
});
// 用户点击按钮后
button.addEventListener('click', () => {
video.playbackRate = 1.8;
localStorage.setItem('videoSpeed', '1.8');
});
倍速控制看着简单,但跨端行为差异大,特别是 iOS 的静默失效和 localStorage 的类型陷阱,最容易漏测。动手前先在目标设备上验证 playbackRate 的读写是否真实生效,比写十行逻辑都管用。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











