AudioTrackList: addtrack event

Limited availability

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

Das addtrack-Ereignis wird ausgelöst, wenn ein Track zu einer AudioTrackList hinzugefügt wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

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

onaddtrack = (event) => { }

Ereigniseigenschaften

TrackEvent basiert auf Event, daher sind die Eigenschaften von Event auch auf TrackEvent-Objekten verfügbar.

track Schreibgeschützt: Das DOM-Track-Objekt, auf das sich das Ereignis bezieht. Wenn nicht null, ist dies immer ein Objekt eines der Medientrack-Typen: AudioTrack, VideoTrack oder TextTrack.

Das addtrack-Ereignis wird aufgerufen, wenn ein neuer Track zu dem Medienelement hinzugefügt wird, dessen Audiotracks durch das AudioTrackList-Objekt dargestellt werden. Dies geschieht, wenn Tracks zu dem Element hinzugefügt werden, wenn die Medien erstmals an das Element angehängt werden; ein addtrack-Ereignis tritt für jeden Audiotrack in der Medienressource auf.

Dieses Ereignis kann nicht abgebrochen werden und breitet sich nicht aus.

Anwendungsfälle

Sie können dieses Ereignis verwenden, um auf einen neuen, verfügbaren Audiotrack zu reagieren. Sie möchten möglicherweise Ihre UI-Elemente aktualisieren, um die Auswahl des neuen Audiotracks durch den Benutzer zu ermöglichen.

Beispiele

Verwendung von addEventListener():

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

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

Verwendung der onaddtrack-Ereignishandler-Eigenschaft:

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

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