HTMLMediaElement : propriété audioTracks
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La propriété en lecture seule audioTracks de l'interface HTMLMediaElement retourne 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 HTML <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.
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.
const video = document.getElementById("video");
for (const track of video.audioTracks) {
track.enabled = false;
}
Spécifications
| Spécification |
|---|
| HTML # dom-media-audiotracks-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
HTMLMediaElement: utilisée pour définir la propriétéHTMLMediaElement.audioTracks - Les éléments HTML
<audio>,<video> - Les interfaces
AudioTrack,AudioTrackList