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
# dom-media-audiotracks-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
audioTracks

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.

Siehe auch