AudioTrackList: addtrack-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Vollständige Kompatibilität anzeigen
Mehr erfahren

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

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:

onaddtrack = (event) => { }

Das Ereignis addtrack wird jedes Mal ausgelöst, wenn dem Medienelement, dessen Audio-Tracks durch das AudioTrackList-Objekt repräsentiert werden, ein neuer Track hinzugefügt wird. Dies geschieht auch, wenn beim ersten Verknüpfen eines Mediums mit dem Element dessen Tracks hinzugefügt werden. Für jeden Audio-Track der Medienressource wird dann ein addtrack-Ereignis ausgelöst.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.

Anwendungsfälle

Sie können dieses Ereignis nutzen, um auf die Verfügbarkeit eines neuen Audio-Tracks zu reagieren. Beispielsweise können Sie Ihre Benutzeroberfläche aktualisieren, damit Benutzer den neuen Audio-Track auswählen können.

Beispiele

Mit addEventListener():

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

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

Mit der Event-Handler-Eigenschaft onaddtrack (beachten Sie jedoch, dass dadurch gegebenenfalls andere mit onaddtrack hinzugefügte Event-Listener ersetzt werden):

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

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