aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/htmlmediaelement/playbackrate/index.html
blob: 1cb8e9c0889a06e8e216a7551c264fe16bf2a6c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
---
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> が負の数であれば、メディアは逆方向に再生されます。</p>

<p>音声は、逆方向の再生であったり、早送りやスロー再生が実用的な範囲を外れていた場合 (例えば、 Gecko は <code>0.25</code> から <code>5.0</code> の範囲であれば) ミュートされます。</p>

<p>既定では音声の高さが修正され、どの速度でも同じになります。ブラウザーによっては、これを制御するために標準外の <code>preservespitch</code> プロパティを実装しています。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="brush: js">// 動画
<var>video</var>.playbackRate = 1.5;
// 音声
<var>audio</var>.playbackRate = 1.0;
</pre>

<h3 id="Value" name="Value"></h3>

<p><code><a href="https://en.wikipedia.org/wiki/Double-precision_floating-point_format">double</a></code> 型。 <code>1.0</code> は「通常の速度」で、 <code>1.0</code> より小さければ通常より遅く、大きければ通常より早く再生されます。 (<strong>既定値:</strong> <code>1.0</code>)</p>

<h2 id="Example" name="Example"></h2>

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

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', "#dom-media-playbackrate", "HTMLMediaElement.playbackRate")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', "embedded-content-0.html#htmlmediaelement", "HTMLMediaElement.playbackRate")}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

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

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{domxref("HTMLMediaElement")}} で定義しています。</li>
</ul>