VideoTrack
VideoTrack インターフェイスは、<video> 要素からの単一の動画トラックを表します。 VideoTrack オブジェクトにアクセスするための最も一般的な用途は、その <video> 要素のアクティブ動画トラックにするために、その selected プロパティを切り替えることです。
プロパティ
selected-
動画トラックがアクティブかどうかを制御する Boolean の値。 同時にアクティブにできる動画トラックは 1 つだけなので、別のトラックがアクティブなときに、あるトラックでこのプロパティを
trueに設定すると、アクティブであったトラックは非アクティブになります。 id読取専用-
メディア内のトラックを一意に識別する
DOMString。この ID を使用して、VideoTrackList.getTrackById()を呼び出して、動画トラックリスト内の特定のトラックを見つけることができます。 メディアが Media Fragments URI 仕様(その日本語訳)に従ってメディアフラグメントによるシークをサポートしている場合は、ID を URL のフラグメント部分として使用することもできます。 kind読取専用-
トラックが属するカテゴリを指定する
DOMString。 例えば、メイン動画トラックには"main"というkindがあります。 label読取専用-
トラックに人間が読めるラベルを提供する
DOMString。 例えば、kindが"sign"のトラックには"手話通訳"というlabelが付いている場合があります。 ラベルが指定されていない場合、この文字列は空です。 language読取専用-
動画トラックの主要言語を指定する
DOMString、または不明の場合は空の文字列。 言語は、"en-US"または"pt-BR"などの BCP 47(RFC 5646)言語コードとして指定されています。 sourceBuffer読取専用-
トラックを作成した
SourceBuffer。トラックがSourceBufferによって作成されなかった場合、またはSourceBufferがその親メディアソースのMediaSource.sourceBuffers属性から取り除かれた場合は、null を返します。
使用上の注意
特定のメディア要素の VideoTrack を取得するには、その要素の videoTracks プロパティを使用します。 このプロパティは、メディアに含まれる個々のトラックを取得できる VideoTrackList オブジェクトを返します。
js
var el = document.querySelector("video");
var tracks = el.videoTracks;
その後、配列の構文または forEach() などの関数を使用して、メディアの個々のトラックにアクセスできます。
この最初の例は、メディア上の最初の動画トラックを取得します。
js
var firstTrack = tracks[0];
次の例では、メディアのすべての動画トラックをスキャンして、(変数 userLanguage から取得した)ユーザーの優先言語の最初の動画トラックをアクティブにします。
js
for (var i = 0; i < tracks.length; i++) {
if (tracks[i].language === userLanguage) {
tracks[i].selected = true;
break;
}
});
language は標準(RFC 5646)形式です。 例えば、アメリカ英語の場合、これは "en-US" になります。
仕様
| Specification |
|---|
| HTML Standard # videotrack |
ブラウザーの互換性
BCD tables only load in the browser