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

View in English Always switch to English

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 einen einzelnen Audiotrack von einem der HTML-Medienelemente, <audio> oder <video>.

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

Instanz-Eigenschaften

enabled

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

id Schreibgeschützt

Ein String, der den Track innerhalb der Medien eindeutig identifiziert. Diese ID kann verwendet werden, um einen bestimmten Track in einer Audiotrack-Liste zu finden, indem AudioTrackList.getTrackById() aufgerufen wird. Die ID kann auch als Fragmentteil der URL verwendet werden, wenn die Medien das Suchen durch Medienfragmente gemäß der Media Fragments URI-Spezifikation unterstützen.

kind Schreibgeschützt

Ein String, der die Kategorie angibt, in die der Track fällt. Zum Beispiel hätte der Hauptaudiotrack einen kind von "main".

label Schreibgeschützt

Ein humanlesbarer String für den Track. Beispielsweise könnte ein Audiokommentartrack für einen Film ein label von "Kommentar mit Regisseur Christopher Nolan und den Schauspielern Leonardo DiCaprio und Elliot Page." haben. Dieser String ist leer, wenn kein Label angegeben ist.

language Schreibgeschützt

Ein String, der die Hauptsprache des Audiotracks angibt, oder ein leerer String, wenn unbekannt. Die Sprache wird als BCP 47-Sprach-Tag 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.

Verwendungshinweise

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 Tracks der Medien erhalten können:

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

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

Dieses erste Beispiel erhält den ersten Audiotrack der Medien:

js
const firstTrack = tracks[0];

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

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

Die language wird als ein gültiges BCP 47-Sprach-Tag angegeben, zum Beispiel "en-US" für amerikanisches Englisch.

Beispiel

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

Spezifikationen

Specification
HTML
# audiotrack

Browser-Kompatibilität