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.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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

Syntax

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

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

onaddtrack = (event) => { }

Das addtrack-Ereignis wird jedes Mal aufgerufen, wenn eine neue Spur zu dem Medienelement hinzugefügt wird, dessen Audiospuren durch das AudioTrackList-Objekt dargestellt werden. Dies geschieht, wenn Spuren zum Element hinzugefügt werden, wenn die Medien zum ersten Mal an das Element angehängt werden; für jede Audiospur in der Medienressource tritt ein addtrack-Ereignis auf.

Dieses Ereignis ist nicht abbrechbar und wird nicht gebubbelt.

Anwendungsfälle

Sie können dieses Ereignis verwenden, um auf das Verfügbarwerden einer neuen Audiospur zu reagieren. Sie möchten möglicherweise Ihre UI-Elemente aktualisieren, um beispielsweise die Benutzerwahl der neuen Audiospur 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-Event-Handler-Eigenschaft:

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

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