VideoTrack
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das VideoTrack-Interface repräsentiert eine einzelne Video-Spur von einem <video>-Element.
Der häufigste Grund, auf ein VideoTrack-Objekt zuzugreifen, besteht darin, seine selected-Eigenschaft umzuschalten, um es zur aktiven Video-Spur für das zugehörige <video>-Element zu machen.
Instanzeigenschaften
selected-
Ein Boolescher Wert, der steuert, ob die Video-Spur aktiv ist oder nicht. Zu jedem Zeitpunkt kann nur eine einzige Video-Spur aktiv sein. Wenn diese Eigenschaft für eine Spur auf
truegesetzt wird, während eine andere Spur aktiv ist, wird die andere Spur inaktiv. idSchreibgeschützt-
Eine Zeichenkette, die die Spur innerhalb des Mediums eindeutig identifiziert. Diese ID kann verwendet werden, um eine bestimmte Spur innerhalb einer Video-Spurliste mithilfe des Aufrufs von
VideoTrackList.getTrackById()zu lokalisieren. Die ID kann auch als Teil des URL-Fragments verwendet werden, wenn das Medium das Suchen nach Medienfragmenten gemäß der Media Fragments URI-Spezifikation unterstützt. kindSchreibgeschützt-
Eine Zeichenkette, die die Kategorie angibt, in die die Spur fällt. Zum Beispiel würde die Hauptvideo-Spur eine
kindvon"main"haben. labelSchreibgeschützt-
Eine Zeichenkette, die eine menschenlesbare Bezeichnung für die Spur bereitstellt. Beispielsweise könnte eine Spur mit
kind"sign"einlabelvon"Eine Gebärdensprache-Interpretation"haben. Diese Zeichenkette ist leer, wenn keine Bezeichnung bereitgestellt wird. languageSchreibgeschützt-
Eine Zeichenkette, die die Hauptsprache der Video-Spur angibt oder eine leere Zeichenkette, wenn unbekannt. Die Sprache wird als BCP 47 Sprach-Tag angegeben, wie zum Beispiel
"en-US"oder"pt-BR". sourceBufferSchreibgeschützt-
Der
SourceBuffer, der die Spur erstellt hat. Gibt null zurück, wenn die Spur nicht von einemSourceBuffererstellt wurde oder derSourceBufferaus dem AttributMediaSource.sourceBuffersder übergeordneten Medienquelle entfernt wurde.
Nutzungshinweise
Um eine VideoTrack für ein gegebenes Media-Element zu erhalten, verwenden Sie die videoTracks-Eigenschaft des Elements. Diese gibt ein VideoTrackList-Objekt zurück, aus dem Sie die einzelnen im Medium enthaltenen Spuren abrufen können:
const el = document.querySelector("video");
const tracks = el.videoTracks;
Sie können dann auf die einzelnen Spuren des Mediums mit entweder der Array-Syntax oder mit Funktionen wie forEach() zugreifen.
Dieses erste Beispiel holt die erste Video-Spur im Medium:
const firstTrack = tracks[0];
Das nächste Beispiel durchsucht alle Video-Spuren des Mediums und aktiviert die erste Video-Spur, die in der vom Benutzer bevorzugten Sprache ist (die aus einer Variablen userLanguage übernommen wird).
for (const track of tracks) {
if (track.language === userLanguage) {
track.selected = true;
break;
}
}
Die language wird als ein gültiges BCP 47 Sprach-Tag angegeben, zum Beispiel "en-US" für amerikanisches Englisch.
Spezifikationen
| Specification |
|---|
| HTML> # videotrack> |
Browser-Kompatibilität
Loading…