AudioTrack

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das AudioTrack-Interface repräsentiert eine einzelne Audiospur von einem der HTML-Medienelemente, <audio> oder <video>.

Der häufigste Anwendungsfall für den Zugriff auf ein AudioTrack-Objekt besteht darin, seine enabled-Eigenschaft zu toggeln, um die Spur stummzuschalten oder die Stummschaltung aufzuheben.

Instanz-Eigenschaften

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 Nur lesbar

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 Nur lesbar

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

label Nur lesbar

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 Nur lesbar

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 Nur lesbar

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.

Verwendungshinweise

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:

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

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

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

Beispiel

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.

Spezifikationen

Specification
HTML Standard
# audiotrack

Browser-Kompatibilität

BCD tables only load in the browser