AudioTrack

enabled

Ein Boolescher Wert, der steuert, ob der Audiotrack aktiviert ist oder nicht. Wenn dieser Wert auf false gesetzt wird, wird der Ton des Tracks stummgeschaltet.

id Schreibgeschützt

Eine Zeichenkette, die den Track innerhalb der Medien eindeutig identifiziert. Diese ID kann verwendet werden, um einen spezifischen Track innerhalb einer Audiotrackliste zu lokalisieren, indem AudioTrackList.getTrackById() aufgerufen wird. Die ID kann auch als Fragmentteil der URL verwendet werden, wenn das Medium laut der Media Fragments URI-Spezifikation das Suchen nach Medienfragmenten unterstützt.

kind Schreibgeschützt

Eine Zeichenkette, die die Kategorie angibt, in die der Track fällt. Beispielsweise hätte der Hauptaudiotrack kind den Wert "main".

label Schreibgeschützt

Eine Zeichenkette, die eine für Menschen lesbare Bezeichnung für den Track bereitstellt. Beispielsweise könnte ein Audiokommentar-Track für einen Film ein label mit dem Wert "Kommentar mit Regisseur John Q. Public und den Schauspielern John Doe und Jane Eod." haben. Diese Zeichenkette ist leer, wenn keine Bezeichnung angegeben wird.

language Schreibgeschützt

Eine Zeichenkette, die die Primärsprache des Audiotracks angibt, oder eine leere Zeichenkette, wenn unbekannt. Die Sprache wird als BCP 47 (RFC 5646) Sprachcode angegeben, wie "en-US" oder "pt-BR".

sourceBuffer Schreibgeschützt

Der SourceBuffer, der den Track erstellt hat. Gibt null zurück, wenn der Track nicht von einem SourceBuffer erstellt wurde oder der SourceBuffer aus dem MediaSource.sourceBuffers-Attribut seiner übergeordneten Medienquelle entfernt wurde.

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

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

Sie können dann auf die einzelnen Tracks des Mediums entweder mit Array-Syntax oder Funktionen wie forEach() zugreifen.

Dieses erste Beispiel erhält den ersten Audiotrack des Mediums:

const firstTrack = tracks[0];

Das nächste Beispiel durchsucht alle Audiotracks des Mediums, aktiviert diejenigen, die in der vom Benutzer bevorzugten Sprache sind (aus einer Variablen userLanguage übernommen) und deaktiviert alle anderen.

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

Die language ist im standardmäßigen (RFC 5646) Format. Für US-Englisch wäre dies beispielsweise "en-US".

Siehe AudioTrack.label für ein einfaches Beispiel, das zeigt, wie man ein Array von Track-Arten und Bezeichnungen für ein bestimmtes Medienelement erhält, gefiltert nach Art.