html5video标签如何调整播放速度_playbackRate属性设置方法【技巧】

絕刀狂花 2026-01-09 00:00:00 次阅读

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});
}
});