HTMLMediaElement.audioTracks

Limited availability

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

La propriété audioTracks est une propriété en lecture seule rattachée à l'interface HTMLMediaElement qui renvoie un objet AudioTrackList répertoriant tous les objets AudioTrack représentant les pistes audio de l'élément multimédia.

L'élément multimédia peut être soit un élément <audio> ou un élément <video>.

La liste renvoyée est dynamique ; c'est-à-dire que lorsque des pistes sont ajoutées et supprimées de l'élément multimédia, le contenu de la liste change dynamiquement. Une fois que vous avez une référence à la liste, vous pouvez surveiller les modifications pour détecter l'ajout de nouvelles pistes audio ou la suppression de pistes existantes. Vous pouvez consulter les gestionnaires d'évènements associés à AudioTrackList pour en savoir plus sur les modifications apportées à la liste des pistes d'un élément multimédia.

Syntaxe

js
let audioTracks = mediaElement.audioTracks;

Valeur

Un objet AudioTrackList représente la liste des pistes audio incluses dans l'élément multimédia. La liste des pistes est accessible en notation matricielle ou en utilisant la méthode getTrackById() de l'objet.

Chaque piste est représentée par un objet AudioTrack qui fournit des informations sur la piste.

Exemples

Dans cet exemple, toutes les pistes audio d'un élément donné sont coupées.

HTML

Le fragment HTML contient l'élément média en question.

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

JavaScript

Le code JavaScript gère la mise en sourdine des pistes audio de l'élément vidéo.

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

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

Spécifications

Specification
HTML
# dom-media-audiotracks-dev

Compatibilité des navigateurs

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.

Voir aussi