HTMLMediaElement.playbackRate

HTMLMediaElement.playbackRate 属性设置媒体文件播放时的速率。这用于实现让用户控制快放、慢放等。正常播放速率乘以该值表示当前的播放速率,所以 1.0 表示一个正常的播放速率。

playbackRate 设为负值不可以实现倒播。

媒体文件倒着播放时,或者播放速率低于或高于浏览器内核规定的可用范围(比如,Gecko 约定范围是 0.25 ~ 5.0)时,播放过程将静音。

任意播放速率下,音频的音调将默认与其匹配。一些浏览器实现了非标准的 HTMLMediaElement.preservesPitch 非标准 属性来进行音调控制。

语法

js
// video
video.playbackRate = 1.5;
// audio
audio.playbackRate = 1.0;

赋值说明

浮点数 1.0 是 "正常速度",比 1.0 小的值使媒体文件播放的慢于正常速度,比 1.0 大的值使播放变得快于正常速度。

示例

js
var obj = document.createElement("video");
console.log(obj.playbackRate); // 1

规范

Specification
HTML
# dom-media-playbackrate-dev

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
playbackRate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support

请参阅