HTMLMediaElement.audioTracks
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/fr/web/api/html_dom_api/index.md)
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
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.
<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>AudioTracketAudioTrackList