HTMLMediaElement: audioTracks-Eigenschaft

Limited availability

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

Die schreibgeschützte audioTracks-Eigenschaft von HTMLMediaElement-Objekten gibt ein AudioTrackList-Objekt zurück, das alle AudioTrack-Objekte auflistet, die die Audio-Tracks des Media-Elements darstellen.

Das Media-Element kann entweder ein <audio>-Element oder ein <video>-Element sein.

Die zurückgegebene Liste ist live; das heißt, wenn Tracks dem Media-Element hinzugefügt oder entfernt werden, ändert sich der Inhalt der Liste dynamisch. Sobald Sie eine Referenz zur Liste haben, können Sie sie überwachen, um Änderungen zu erkennen, wenn neue Audio-Tracks hinzugefügt oder vorhandene entfernt werden. Siehe AudioTrackList-Ereignisse, um mehr darüber zu erfahren, wie Sie Änderungen an der Track-Liste eines Media-Elements überwachen können.

Wert

Ein AudioTrackList-Objekt, das die Liste der im Media-Element enthaltenen Audio-Tracks darstellt. Auf die Liste der Tracks kann über Array-Notation oder über die getTrackById()-Methode des Objekts zugegriffen werden.

Jeder Track wird durch ein AudioTrack-Objekt dargestellt, das Informationen über den Track bietet.

Beispiele

In diesem Beispiel werden alle Audio-Tracks eines bestimmten Elements stummgeschaltet.

HTML

Das HTML stellt das Element selbst bereit.

html
<video id="video" src="somevideo.mp4"></video>

JavaScript

Der JavaScript-Code kümmert sich um das Stummschalten der Audio-Tracks des Video-Elements.

js
const video = document.getElementById("video");

for (let i = 0; i < video.audioTracks.length; i += 1) {
  video.audioTracks[i].enabled = false;
}

Spezifikationen

Specification
HTML Standard
# dom-media-audiotracks-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch