HTMLMediaElement.audioTracks
La propriété audioTracks est une propriété en lecture seule rattachée à l'interface HTMLMediaElement qui renvoie un objet AudioTrackList (en-US) répertoriant tous les objets AudioTrack (en-US) 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 (en-US) associés à AudioTrackList (en-US) pour en savoir plus sur les modifications apportées à la liste des pistes d'un élément multimédia.
Syntaxe
let audioTracks = mediaElement.audioTracks;
Valeur
Un objet AudioTrackList (en-US) 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() (en-US) de l'objet.
Chaque piste est représentée par un objet AudioTrack (en-US) 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.
<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.
let video = document.getElementById("video");
for (let i = 0; i < video.audioTracks.length; i += 1) {
video.audioTracks[i].enabled = false;
}
Spécifications
| Specification |
|---|
| HTML Standard # dom-media-audiotracks-dev |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- L'interface qui porte cette propriété,
HTMLMediaElement. <audio>et<video>AudioTrack(en-US) etAudioTrackList(en-US)