AudioTrackList
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die AudioTrackList
Schnittstelle wird verwendet, um eine Liste der Audiotracks in einem gegebenen HTML-Medienelement darzustellen, wobei jeder Track durch ein separates AudioTrack
Objekt in der Liste repräsentiert wird.
Eine Instanz dieses Objekts kann mit HTMLMediaElement.audioTracks
abgerufen werden. Auf die einzelnen Tracks kann mit Array-Syntax zugegriffen werden.
Instanz-Eigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrer Elternelement-Schnittstelle, EventTarget
.
length
Schreibgeschützt-
Die Anzahl der Tracks in der Liste.
Instanz-Methoden
Diese Schnittstelle erbt auch Methoden von ihrer Elternelement-Schnittstelle, EventTarget
.
getTrackById()
-
Gibt den
AudioTrack
zurück, der in derAudioTrackList
gefunden wurde und dessenid
mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wirdnull
zurückgegeben.
Ereignisse
addtrack
-
Wird ausgelöst, wenn ein neuer Audiotrack zum Medienelement hinzugefügt wurde.
change
-
Wird ausgelöst, wenn ein Track aktiviert oder deaktiviert wurde.
removetrack
-
Wird ausgelöst, wenn ein Audiotrack aus dem Medienelement entfernt wurde.
Nutzungshinweise
Zusätzlich zur Möglichkeit, direkten Zugriff auf die im Medienelement vorhandenen Audiotracks zu erhalten, erlaubt AudioTrackList
das Setzen von Ereignis-Handlern für die addtrack
und removetrack
Ereignisse, sodass Sie erkennen können, wann Tracks zum oder vom Stream des Medienelements hinzugefügt oder entfernt werden. Siehe die addtrack
und removetrack
Ereignisse für Details und Beispiele.
Beispiele
Abrufen der Audiotrack-Liste eines Medienelements
Um die AudioTrackList
eines Medienelements zu erhalten, verwenden Sie dessen audioTracks
Eigenschaft.
const audioTracks = document.querySelector("video").audioTracks;
Überwachung von Änderungen der Track-Anzahl
In diesem Beispiel haben wir eine App, die Informationen über die Anzahl der verfügbaren Kanäle anzeigt. Um sicherzustellen, dass diese Informationen aktuell bleiben, werden Handler für die addtrack
und removetrack
Ereignisse eingerichtet.
audioTracks.onaddtrack = updateTrackCount;
audioTracks.onremovetrack = updateTrackCount;
function updateTrackCount(event) {
trackCount = audioTracks.length;
drawTrackCountIndicator(trackCount);
}
Spezifikationen
Specification |
---|
HTML Standard # audiotracklist-and-videotracklist-objects |
Browser-Kompatibilität
BCD tables only load in the browser