AudioTrackList

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

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

Browser-Kompatibilität