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.

EventTarget AudioTrackList

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrer Elternelement-Schnittstelle, EventTarget.

length Nur lesbar

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 der AudioTrackList gefunden wurde und dessen id mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wird null 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.

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

js
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