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
true
gesetzt wird, während eine andere Spur aktiv ist, wird die andere Spur inaktiv. id
Schreibgeschü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. kind
Schreibgeschützt-
Eine Zeichenkette, die die Kategorie angibt, in die die Spur fällt. Zum Beispiel würde die Hauptvideo-Spur eine
kind
von"main"
haben. label
Schreibgeschützt-
Eine Zeichenkette, die eine menschenlesbare Bezeichnung für die Spur bereitstellt. Beispielsweise könnte eine Spur mit
kind
"sign"
einlabel
von"Eine Gebärdensprache-Interpretation"
haben. Diese Zeichenkette ist leer, wenn keine Bezeichnung bereitgestellt wird. language
Schreibgeschü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"
. 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
der ü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…