此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

HTMLMediaElement.playbackRate

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

浏览器兼容性

请参阅