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 in einer Liste von Audiospuren durch Aufruf von AudioTrackList.getTrackById() zu finden. 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

Eine Zeichenfolge, die die Kategorie angibt, in die die Spur fällt. Zum Beispiel hätte die Haupt-Audiospur ein kind von "main".

label Schreibgeschützt

Eine Zeichenfolge, die eine für Menschen lesbare Bezeichnung für die Spur liefert. Zum Beispiel könnte eine Audiokommentarspur für einen Film ein label von "Commentary with director John Q. Public and actors John Doe and Jane Eod." haben. Diese Zeichenfolge ist leer, wenn kein Label angegeben wurde.

language Schreibgeschützt

Eine Zeichenfolge, die die hauptsächliche Sprache der Audiospur angibt, oder eine leere Zeichenfolge, wenn unbekannt. Die Sprache wird als BCP 47 (RFC 5646) Sprachcode angegeben, 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 MediaSource.sourceBuffers-Attribut der ü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 Spuren des Mediums erhalten können:

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

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

Dieses erste Beispiel erhält 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), und deaktiviert alle anderen.

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

Die language befindet sich in standardisierter (RFC 5646) Form. 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 -labels für ein angegebenes Medienelement erhält und nach Art filtert.