AudioTrack

enabled

Ein boolescher Wert, der steuert, ob der Ton der Audiospur aktiviert ist oder nicht. Wenn dieser Wert auf false gesetzt wird, wird der Ton der Spur stummgeschaltet.

id Schreibgeschützt

Eine Zeichenfolge, die die Spur innerhalb des Mediums eindeutig identifiziert. Diese ID kann verwendet werden, um eine bestimmte Spur innerhalb einer Audiotrackliste zu finden, indem AudioTrackList.getTrackById() aufgerufen wird. Die ID kann auch als Fragmentteil der URL verwendet werden, wenn das Medium das Suchen anhand von Medienfragmenten gemäß der Media Fragments URI-Spezifikation unterstützt.

kind Schreibgeschützt

Eine Zeichenfolge, die die Kategorie angibt, in die die Spur fällt. Beispielsweise hätte die hauptsächliche Audiospur einen kind von "main".

label Schreibgeschützt

Eine Zeichenfolge, die eine lesbare Beschriftung für die Spur bereitstellt. Beispielsweise könnte eine Audiokommentarspur für einen Film eine label von "Kommentar mit Regisseur Christopher Nolan und den Schauspielern Leonardo DiCaprio und Elliot Page." haben. Diese Zeichenfolge ist leer, wenn keine Beschriftung angegeben ist.

language Schreibgeschützt

Eine Zeichenfolge, die die Hauptsprache der Audiospur angibt, oder eine leere Zeichenfolge, wenn sie unbekannt ist. Die Sprache wird als BCP 47 (RFC 5646) Sprachcode 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 seiner übergeordneten Medienquelle entfernt wurde.

Um ein AudioTrack für ein gegebenes Medienelement zu erhalten, verwenden Sie die audioTracks-Eigenschaft des Elements, die ein AudioTrackList-Objekt zurückgibt, aus dem Sie die einzelnen Spuren, die im Medium enthalten sind, erhalten können:

const el = document.querySelector("video");
const tracks = el.audioTracks;

Sie können dann die einzelnen Spuren des Mediums entweder mit Hilfe der Arraysyntax oder Funktionen wie forEach() zugreifen.

Dieses erste Beispiel ermittelt die erste Audiospur im Medium:

const firstTrack = tracks[0];

Das nächste Beispiel durchsucht alle Audiospuren des Mediums und aktiviert diejenigen, die in der bevorzugten Sprache des Benutzers sind (aus einer Variablen userLanguage entnommen), und deaktiviert alle anderen.

tracks.forEach((track) => {
  track.enabled = track.language === userLanguage;
});

Die language ist im Standard- (RFC 5646) Format. Für US-Englisch wäre dies zum Beispiel "en-US".

Siehe AudioTrack.label für ein Beispiel, das zeigt, wie man ein Array von Spurarten und Bezeichnungen für ein angegebenes Medienelement erhält, gefiltert nach Art.