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, ein label 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 einem SourceBuffer erstellt wurde oder der SourceBuffer aus dem Attribut MediaSource.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:

js
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:

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

js
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