VideoTrackList.onaddtrack

VideoTrackListonaddtrack プロパティは、addtrack イベントが発生したときに呼び出されるイベントハンドラで、VideoTrackList が表す動画トラックを持つメディア要素に新しい動画トラックが追加されたことを示します。

イベントは TrackEvent オブジェクトの形式でイベントハンドラに渡され、その track プロパティは新しく追加されたトラックを識別します。

: addEventListener() を使用して、addtrack イベント用のハンドラを追加することもできます。

構文

VideoTrackList.onaddtrack = eventHandler;

onaddtrack は、 track プロパティでどの動画トラックがメディアに追加されたかを示す TrackEvent オブジェクトを入力として受け取る関数を設定します。

使用上の注意

addtrack イベントは、動画トラックを VideoTrackList オブジェクトで表すメディア要素に新しいトラックが追加されるたびに呼び出されます。 これは、メディアが最初に要素に添付されたときにトラックが要素に追加されたときに発生します。 メディアリソース内の動画トラックごとに1つの addtrack イベントが発生します。

このスニペットは、新しく追加されたトラックを表す VideoTrack オブジェクトを渡して、addToTrackList() 関数を呼び出す addtrack イベントのハンドラを確立します。 このシナリオでは、その関数の役割は、選択可能な動画トラックのリストに新しいトラックを追加することです。

document.querySelector("video").videoTracks.onaddtrack = function(event) {
  addToTrackList(event.track);
};

仕様

仕様 状態 コメント
HTML Living Standard
VideoTrackList: onaddtrack の定義
現行の標準  

ブラウザーの互換性

BCD tables only load in the browser