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