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 einemSourceBuffer
erstellt wurde oder derSourceBuffer
aus demMediaSource.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:
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"
.
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