SourceBuffer.mode
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
SourceBuffer
インターフェイスの mode
プロパティは、メディアセグメントを SourceBuffer
に任意の順序で追加できるか、厳密な順序で追加できるかを制御します。
使用可能な2つの値は次のとおりです。
segments
: メディアセグメントのタイムスタンプが、セグメントの再生順序を決定します。 セグメントは、任意の順序でSourceBuffer
に追加できます。sequence
: セグメントがSourceBuffer
に追加される順序により、セグメントの再生順序を決定します。 セグメントのタイムスタンプは、この順序に従ってセグメントに対して自動的に生成されます。
mode
値は、MediaSource.addSourceBuffer()
を使用して SourceBuffer
が作成されるときに最初に設定されます。 メディアセグメントにタイムスタンプが既に存在する場合、値は segments
に設定されます。 そうでない場合、値は sequence
に設定されます。
初期値が sequence
のときに mode
プロパティ値を segments
に設定しようとすると、例外がスローされます。 sequence
モードでは、既存のセグメントの順序を維持する必要があります。 ただし、値を segments
から sequence
に変更することはできます。 これは、再生順序が固定され、これを反映するために新しいタイムスタンプが生成されることを意味します。
このプロパティは、SourceBuffer
が appendBuffer()
または remove()
の呼び出しを処理している間は変更できません。
構文
var myMode = sourceBuffer.mode; sourceBuffer.mode = 'sequence';
値
例外
このプロパティに新しい値を設定すると、次の例外がスローされる場合があります。
例外 | 説明 |
---|---|
InvalidAccessError |
初期値が sequence の場合に、値を segments に設定しようとしました。 |
InvalidStateError |
SourceBuffer オブジェクトが更新中(つまり、その SourceBuffer.updating プロパティが現在 true )、この SourceBuffer に追加された最後のメディアセグメントが不完全、またはこの SourceBuffer が MediaSource から取り除かれています。 |
例
このスニペットは、sourceBuffer
のモードが、 現在 'segments'
に設定されている場合、'sequence'
に設定します。 したがって、再生順序は、メディアセグメントを追加した順に設定されます。
var curMode = sourceBuffer.mode;
if (curMode == 'segments') {
sourceBuffer.mode = 'sequence';
}
仕様
仕様 | 状態 | コメント |
---|---|---|
Media Source Extensions mode の定義 |
勧告 | 初期定義 |
ブラウザーの互換性
BCD tables only load in the browser