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.
lengthSchreibgeschützt-
Die Anzahl der Spuren in der Liste.
selectedIndexSchreibgeschützt-
Der Index der aktuell ausgewählten Spur, falls vorhanden, oder
−1andernfalls.
Instanz-Methoden
Dieses Interface erbt auch Methoden von seinem übergeordneten Interface, EventTarget.
getTrackById()-
Gibt die
VideoTrackzurück, die innerhalb derVideoTrackListgefunden wird und derenidmit dem angegebenen String übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wirdnullzurü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 # audiotracklist-and-videotracklist-objects |
Browser-Kompatibilität
Loading…