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.
addEventListener("addtrack", (event) => { })
onaddtrack = (event) => { }
Ereignistyp
Ein TrackEvent
. Erbt von Event
.
Ereigniseigenschaften
TrackEvent
basiert auf Event
, daher sind 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
oderTextTrack
).
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()
:
const videoElement = document.querySelector("video");
videoElement.audioTracks.addEventListener("addtrack", (event) => {
console.log(`Audio track: ${event.track.label} added`);
});
Verwendung der onaddtrack
Ereignishandlereigenschaft:
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
- Verwandte Ereignisse:
removetrack
,change
- Dieses Ereignis bei
VideoTrackList
zielt ab auf:addtrack
- Dieses Ereignis bei
MediaStream
zielt ab auf:addtrack
- Media Capture and Streams API
- WebRTC