Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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

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

js
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