AudioTrackList: addtrack Ereignis

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 Ereignishandlereigenschaft.

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

onaddtrack = (event) => { }

Ereignistyp

Ereigniseigenschaften

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

track Nur lesbar

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).

Beschreibung

Auslöser

Das addtrack Ereignis wird aufgerufen, wann immer ein neuer Track zu dem Medienelement hinzugefügt wird, dessen Audiospuren durch das AudioTrackList Objekt repräsentiert werden. Dies geschieht, wenn Tracks zu dem Element hinzugefügt werden, wenn die Medien erstmals dem Element zugeordnet werden; für jede Audiospur in der Medienressource tritt ein addtrack Ereignis auf.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht propagiert.

Anwendungsfälle

Sie können dieses Ereignis nutzen, um auf eine neue verfügbare Audiospur zu reagieren. Beispielsweise könnten Sie Ihre Benutzeroberflächenelemente aktualisieren, um die Benutzerauswahl der neuen Audiospur zu ermöglichen.

Beispiele

Verwendung von addEventListener():

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

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

Verwendung der onaddtrack Ereignishandlereigenschaft:

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

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch