---
title: HTMLMediaElement.playbackRate
slug: Web/API/HTMLMediaElement/playbackRate
tags:
  - API
  - HTML DOM
  - HTMLMediaElement
  - Property
translation_of: Web/API/HTMLMediaElement/playbackRate
---
<div>{{APIRef("HTML DOM")}}</div>

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

<p>将 <code>playbackRate</code> 设为负值<strong>不可以</strong>实现倒播。</p>

<p>媒体文件倒着播放时，或者播放速率低于或高于浏览器内核规定的可用范围（比如，Gecko约定范围是0.25～5.0）时，播放过程将静音。</p>

<p>任意播放速率下，音频的音调将默认与其匹配。一些浏览器实现了非标准的 {{domxref("HTMLMediaElement.preservesPitch")}} {{non-standard_inline}} 属性来进行音调控制。</p>

<h2 id="Syntax" name="Syntax">语法</h2>

<pre class="brush: js notranslate">// video
<var>video</var>.playbackRate = 1.5;
// audio
<var>audio</var>.playbackRate = 1.0;</pre>

<h3 id="赋值说明">赋值说明</h3>

<p>浮点数1.0 是 "正常速度"， 比 1.0 小的值使媒体文件播放的慢于正常速度，比1.0大的值使播放变得快于正常速度.</p>

<h2 id="示例">示例</h2>

<pre class="brush: js notranslate">var obj = document.createElement('video');
console.log(obj.playbackRate); // 1</pre>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">特性</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "the-video-element.html#htmlmediaelement", "HTMLMediaElement.playbackRate")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>No change from {{SpecName('HTML5 W3C')}}</td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#htmlmediaelement", "HTMLMediaElement.playbackRate")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("api.HTMLMediaElement.playbackRate")}}</p>

<h2 id="See_Also" name="See_Also">请参阅</h2>

<ul>
 <li>接口定义 {{domxref("HTMLMediaElement")}}.</li>
</ul>