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

Eine Instanz dieses Objekts kann überHTMLMediaElement.videoTracks abgerufen werden. Auf die einzelnen Spuren kann mit Array-Syntax oder Funktionen wieforEach() zugegriffen werden.

Instanz-Eigenschaften

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

lengthSchreibgeschützt

Die Anzahl der Spuren in der Liste.

selectedIndexSchreibgeschützt

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 dieVideoTrack zurück, die innerhalb derVideoTrackList gefunden wird und derenid mit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wirdnull zurückgegeben.

Ereignisse

addtrack

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

change

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

removetrack

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

Hinweise zur Verwendung

Zusätzlich zur direkten Zugriffsmöglichkeit auf die vorhandenen Videospuren eines Medien-Elements ermöglicht IhnenVideoTrackList, Ereignishandler für dieaddtrack- undremovetrack-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 dieVideoTrackList eines Medien-Elements zu erhalten, verwenden Sie dievideoTracks-Eigenschaft.

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 dieaddtrack- undremovetrack-Ereignisse eingerichtet.

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

Spezifikationen

Browser-Kompatibilität