VideoTrackList

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das VideoTrackList-Interface wird verwendet, um eine Liste der Videospuren darzustellen, die in einem <video>-Element enthalten sind. Jede Spur wird durch ein separates VideoTrack-Objekt in der Liste repräsentiert.

Eine Instanz dieses Objekts kann über HTMLMediaElement.videoTracks abgerufen werden. Auf die einzelnen Spuren kann mit Array-Syntax oder Funktionen wie forEach() zugegriffen werden.

EventTarget VideoTrackList

Instanz-Eigenschaften

Dieses Interface erbt auch Eigenschaften von seinem übergeordneten Interface, EventTarget.

length Nur lesbar

Die Anzahl der Spuren in der Liste.

selectedIndex Nur lesbar

Der Index der aktuell ausgewählten Spur, falls vorhanden, oder −1 andernfalls.

Instanz-Methoden

Dieses Interface erbt auch Methoden von seinem übergeordneten Interface, EventTarget.

getTrackById()

Gibt die VideoTrack zurück, die innerhalb der VideoTrackList gefunden wird und deren id mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wird null zurückgegeben.

Ereignisse

addtrack

Wird ausgelöst, wenn eine neue Videospur zum Medien-Element hinzugefügt wurde. Auch über die onaddtrack-Eigenschaft verfügbar.

change

Wird ausgelöst, wenn eine Videospur aktiv oder inaktiv gemacht wurde. Auch über die onchange-Eigenschaft verfügbar.

removetrack

Wird ausgelöst, wenn eine neue Videospur aus dem Medien-Element entfernt wurde. Auch über die onremovetrack-Eigenschaft verfügbar.

Hinweise zur Verwendung

Zusätzlich zur direkten Zugriffsmöglichkeit auf die vorhandenen Videospuren eines Medien-Elements ermöglicht Ihnen VideoTrackList, Ereignishandler für die addtrack- und removetrack-Ereignisse festzulegen, sodass Sie erkennen können, wann Spuren dem Stream des Medien-Elements hinzugefügt oder daraus entfernt werden.

Beispiele

Die Videospurliste eines Medien-Elements abrufen

Um die VideoTrackList eines Medien-Elements zu erhalten, verwenden Sie die videoTracks-Eigenschaft.

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

Änderung der Anzahl der Spuren überwachen

In diesem Beispiel haben wir eine App, die Informationen über die verfügbare Anzahl der Kanäle anzeigt. Um sie aktuell zu halten, werden Handler für die addtrack- und removetrack-Ereignisse eingerichtet.

js
videoTracks.onaddtrack = updateTrackCount;
videoTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = videoTracks.length;
  drawTrackCountIndicator(trackCount);
}

Spezifikationen

Specification
HTML Standard
# audiotracklist-and-videotracklist-objects

Browser-Kompatibilität

BCD tables only load in the browser