VideoTrackList

このインターフェイスは、その親インターフェイスである EventTarget からプロパティを継承しています。

length 読取専用

リスト内のトラック数。

selectedIndex 読取専用

現在選択されているトラックがある場合はそのインデックス、それ以外の場合は -1。

このインターフェイスは、その親インターフェイスである EventTarget からメソッドを継承しています。

getTrackById()

指定された文字列と id が一致する VideoTrackList 内で見つかった VideoTrack を返します。 一致が見つからない場合は、null を返します。

addtrack

新しい映像トラックがメディア要素に追加されたときに発生します。 onaddtrack プロパティからも利用できます。

change

映像トラックがアクティブまたは非アクティブになったときに発生します。 onchange プロパティからも利用できます。

removetrack

映像トラックがメディア要素から取り除かれたときに発生します。 onremovetrack プロパティからも利用できます。

VideoTrackList を使用すると、メディア要素にある映像トラックに直接アクセスできるだけでなく、addtrack および removetrack イベントにイベントハンドラーを設定することができるため、メディア要素のストリームにトラックが追加されたときまたは取り除かれたときを検出できます。

メディア要素の VideoTrackList を取得するには、その videoTracks プロパティを使用します。

const videoTracks = document.querySelector("video").videoTracks;

この例では、利用可能なチャンネル数に関する情報を表示するアプリがあります。 それを最新に保つために、 addtrack および removetrack イベントのためのハンドラーが設定されています。

videoTracks.onaddtrack = updateTrackCount;
videoTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = videoTracks.length;
  drawTrackCountIndicator(trackCount);
}