AudioTrackList.onaddtrack

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

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

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

構文

AudioTrackList.onaddtrack = eventHandler;

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

使用上の注意

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

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

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

仕様

仕様 状態 コメント
HTML Living Standard
AudioTrackList.onaddtrack の定義
現行の標準  
HTML5
AudioTrackList.onaddtrack の定義
勧告  

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
onaddtrackChrome 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge 完全対応 12Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 完全対応 10Opera 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari 完全対応 6.1WebView Android 完全対応 45Chrome Android 完全対応 45
無効
完全対応 45
無効
無効 From version 45: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 32
無効
完全対応 32
無効
無効 From version 32: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS 完全対応 7.1Samsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。