VideoTrackList

Instanz-Eigenschaften

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

length Schreibgeschtzt

Die Anzahl der Spuren in der Liste.

selectedIndex Schreibgeschtzt

Der Index der aktuell ausgewhlten Spur, falls vorhanden, oder 1 andernfalls.

Instanz-Methoden

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

getTrackById()

Gibt die VideoTrack zurck, die innerhalb der VideoTrackList gefunden wird und deren id mit dem angegebenen String bereinstimmt. Wenn keine bereinstimmung gefunden wird, wird null zurckgegeben.

Ereignisse

addtrack

Wird ausgelst, wenn eine neue Videospur zum Medien-Element hinzugefgt wurde. Auch ber die onaddtrack-Eigenschaft verfgbar.

change

Wird ausgelst, wenn eine Videospur aktiv oder inaktiv gemacht wurde. Auch ber die onchange-Eigenschaft verfgbar.

removetrack

Wird ausgelst, wenn eine neue Videospur aus dem Medien-Element entfernt wurde. Auch ber die onremovetrack-Eigenschaft verfgbar.

Hinweise zur Verwendung

Zustzlich zur direkten Zugriffsmglichkeit auf die vorhandenen Videospuren eines Medien-Elements ermglicht Ihnen VideoTrackList, Ereignishandler fr die addtrack- und removetrack-Ereignisse festzulegen, sodass Sie erkennen knnen, wann Spuren dem Stream des Medien-Elements hinzugefgt oder daraus entfernt werden.

Beispiele

Die Videospurliste eines Medien-Elements abrufen

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

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

nderung der Anzahl der Spuren berwachen

In diesem Beispiel haben wir eine App, die Informationen ber die verfgbare Anzahl der Kanle anzeigt. Um sie aktuell zu halten, werden Handler fr die addtrack- und removetrack-Ereignisse eingerichtet.

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

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

Spezifikationen

Browser-Kompatibilitt