AudioTrackList: addtrack イベント

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

addtrack イベントは、トラックが AudioTrackList に追加されたときに発生します。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

イベント型

TrackEvent です。 Event を継承しています。

イベントプロパティ

TrackEvent は Event に基づいているため、 Event のプロパティも TrackEvent オブジェクトで利用できます。

track 読取専用: このイベントが参照している DOM track オブジェクト。 null でなければ、これは常にいずれかのメディアトラック型のオブジェクトになります。AudioTrack、VideoTrack、TextTrack) のいずれかです。

解説

トリガー

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

このイベントはキャンセル不可で、バブリングしません。

用途

このイベントを使用して、新しい音声トラックが利用できるようになったことに反応することができます。例えば、新しい音声トラックをユーザーが選択できるように、 UI 要素を更新することができます。

例

addEventListener() を使用する場合:

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

videoElement.audioTracks.addEventListener("addtrack", (event) => {
  console.log(`Audio track: ${event.track.label} added`);
});

onaddtrack イベントハンドラープロパティを使用する場合:

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

videoElement.audioTracks.onaddtrack = (event) => {
  console.log(`Audio track: ${event.track.label} added`);
};

仕様書

Specification
HTML Standard # event-media-addtrack
HTML Standard # handler-tracklist-onaddtrack

ブラウザーの互換性

BCD tables only load in the browser