DOM

インターフェイス

VideoTrack インターフェイス

→MS

このインターフェイスは、<video> 要素からの単一の動画トラックを表します。VideoTrack オブジェクトにアクセスするための最も一般的な用途は、その <video> 要素のアクティブ動画トラックにするために、その selected プロパティを切り替えることです。

プロパティ

VideoTrack.selected ●

動画トラックがアクティブかどうかを制御する Boolean の値。同時にアクティブにできる動画トラックは 1 つだけなので、別のトラックがアクティブなときに、あるトラックでこのプロパティを true に設定すると、アクティブであったトラックは非アクティブになります。

VideoTrack.id 読取専用 ●

メディア内のトラックを一意に識別する DOMString。この ID を使用して、VideoTrackList.getTrackById() を呼び出して、動画トラックリスト内の特定のトラックを見つけることができます。

メディアが Media Fragments URI 仕様（その日本語訳）に従ってメディア フラグメントによるシークをサポートしている場合は、ID を URL のフラグメント部分として使用することもできます。

VideoTrack.kind 読取専用 ●

トラックが属するカテゴリを指定する DOMString。例えば、メイン動画トラックには "main" という kind があります。

VideoTrack.label 読取専用 ●

トラックに人間が読めるラベルを提供する DOMString。例えば、kind が "sign" のトラックには "手話通訳" という label が付いている場合があります。ラベルが指定されていない場合、この文字列は空です。

VideoTrack.language 読取専用 ●

動画トラックの主要言語を指定する DOMString、または不明の場合は空の文字列。言語は、"en-US" または "pt-BR" などの BCP 47（RFC 5646）言語コードとして指定されています。

VideoTrack.sourceBuffer 読取専用

トラックを作成した SourceBuffer。トラックが SourceBuffer によって作成されなかった場合、または SourceBuffer がその親メディアソースの MediaSource.sourceBuffers 属性から取り除かれた場合は、null を返します。

使用上の注意

特定のメディア要素の VideoTrack を取得するには、その要素の videoTracks プロパティを使用します。このプロパティは、メディアに含まれる個々のトラックを取得できる VideoTrackList オブジェクトを返します。

var el = document.querySelector("video");
var tracks = el.videoTracks;

その後、配列の構文または forEach() などの関数を使用して、メディアの個々のトラックにアクセスできます。

この最初の例は、メディア上の最初の動画トラックを取得します。

var firstTrack = tracks[0];

for (var i = 0; i < tracks.length; i++) {
  if (tracks[i].language === userLanguage) {
    tracks[i].selected = true;
    break;
  }
});

テスト