VideoTrack
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die VideoTrack
-Schnittstelle repräsentiert eine einzelne Videospur aus einem <video>
-Element.
Der häufigste Anwendungsfall für den Zugriff auf ein VideoTrack
-Objekt ist das Umschalten seiner selected
-Eigenschaft, um es zur aktiven Videospur für sein <video>
-Element zu machen.
Instanz-Eigenschaften
selected
-
Ein boolescher Wert, der kontrolliert, ob die Videospur aktiv ist oder nicht. Zu einem bestimmten Zeitpunkt kann nur eine einzige Videospur aktiv sein. Wenn Sie also diese Eigenschaft für eine Spur auf
true
setzen, während eine andere Spur aktiv ist, wird diese andere Spur inaktiv. id
Schreibgeschützt-
Ein string, der die Spur innerhalb des Mediums eindeutig identifiziert. Diese ID kann verwendet werden, um eine spezifische Spur innerhalb einer Videospurliste zu finden, indem
VideoTrackList.getTrackById()
aufgerufen wird. Die ID kann auch als Fragmentteil der URL verwendet werden, wenn das Medium das Suchen nach Medienfragmenten gemäß der Media Fragments URI-Spezifikation unterstützt. kind
Schreibgeschützt-
Ein string, der die Kategorie angibt, in die die Spur fällt. Zum Beispiel würde die Hauptvideospur ein
kind
von"main"
haben. label
Schreibgeschützt-
Ein menschlich lesbares Label für die Spur. Zum Beispiel könnte eine Spur, deren
kind
"sign"
ist, einlabel
von"Eine Gebärdensprach-Interpretation"
haben. Dieser string ist leer, wenn kein Label angegeben ist. language
Schreibgeschützt-
Ein string, der die Hauptsprache der Videospur angibt, oder ein leerer string, wenn unbekannt. Die Sprache wird als BCP 47 (RFC 5646) Sprachcode spezifiziert, wie
"en-US"
oder"pt-BR"
. sourceBuffer
Schreibgeschützt-
Der
SourceBuffer
, der die Spur erstellt hat. Gibt null zurück, wenn die Spur nicht von einemSourceBuffer
erstellt wurde oder derSourceBuffer
aus dem AttributMediaSource.sourceBuffers
seiner übergeordneten Medienquelle entfernt wurde.
Hinweise zur Nutzung
Um eine VideoTrack
für ein gegebenes Medienelement zu erhalten, verwenden Sie die videoTracks
-Eigenschaft des Elements, die ein VideoTrackList
-Objekt zurückgibt, aus dem Sie die einzelnen Spuren im Medium erhalten können:
const el = document.querySelector("video");
const tracks = el.videoTracks;
Sie können dann auf die einzelnen Spuren des Mediums entweder mit der Array-Syntax oder mit Funktionen wie forEach()
zugreifen.
Dieses erste Beispiel erhält die erste Videospur des Mediums:
const firstTrack = tracks[0];
Das nächste Beispiel durchsucht alle Videospuren des Mediums und aktiviert die erste Videospur, die in der vom Benutzer bevorzugten Sprache ist (genommen aus einer Variable userLanguage
).
for (const track of tracks) {
if (track.language === userLanguage) {
track.selected = true;
break;
}
}
Die language
ist im Standardformat (RFC 5646). Für US-Englisch wäre dies zum Beispiel "en-US"
.
Spezifikationen
Specification |
---|
HTML Standard # videotrack |
Browser-Kompatibilität
BCD tables only load in the browser