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 Audiotracks 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 zum Media-Element hinzugefügt oder daraus entfernt werden, ändert sich der Inhalt der Liste dynamisch. Sobald Sie eine Referenz zur Liste haben, können Sie sie auf Änderungen überwachen, um festzustellen, wann neue Audiotracks hinzugefügt oder bestehende entfernt werden. Siehe AudioTrackList-Ereignisse, um mehr darüber zu erfahren, wie man Änderungen in der Trackliste eines Media-Elements überwacht.

Wert

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

Jeder Track wird durch ein AudioTrack-Objekt repräsentiert, das Informationen über den Track bereitstellt.

Beispiele

In diesem Beispiel werden alle Audiotracks eines bestimmten Elements stummgeschaltet.

HTML

Das HTML erstellt das Element selbst.

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

JavaScript

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

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

for (const track of video.audioTracks) {
  track.enabled = false;
}

Spezifikationen

Specification
HTML
# dom-media-audiotracks-dev

Browser-Kompatibilität

Siehe auch