VideoTrack

L'interface VideoTrack représente une seule piste vidéo d'un élément <video>. L'utilisation la plus courante à un objet VideoTrack est de basculer sa propriété selected (en-US) afin d'en faire la piste vidéo active pour l'élément <video>.

Propriétés

selected (en-US)

Une valeur booléenne qui contrôle si la piste vidéo est active ou non. Seule une seule piste vidéo peut être active à un moment donné, donc la définition de cette propriété sur true pour une piste pendant qu'une autre piste est active rendra cette autre piste inactive.

id Lecture seule

Un DOMString qui identifie de manière unique la piste dans le média. Cet identifiant peut être utilisé pour localiser une piste spécifique dans une liste de pistes vidéo en appelant VideoTrackList.getTrackById() (en-US). L'identifiant peut également être utilisé comme partie fragment de l'URL si le support prend en charge la recherche par fragment de support conformément à la spécification UR de fragments de média.

kind (en-US) Lecture seule

Un DOMString spécifiant la catégorie dans laquelle appartient la piste. Par exemple, la piste vidéo principale aurait un type "principale".

label (en-US) Lecture seule

Un DOMString fournissant une étiquette lisible par l'homme pour la piste. Par exemple, une piste dont le type est "signe" peut avoir l'étiquette "Une interprétation en langue des signes". Cette chaîne est vide si aucune étiquette n'est fournie.

language (en-US) Lecture seule

Un DOMString spécifiant la langue principale de la piste vidéo, ou une chaîne vide si elle est inconnue. La langue est spécifié en tant que code de langue BCP 47 (RFC 5646), tel que "en-US" ou "pt-BR".

sourceBuffer (en-US) Lecture seule

Le SourceBuffer (en-US) qui a créé la piste. Renvoie null si la piste n'a pas été créée par un SourceBuffer (en-US) ou le SourceBuffer (en-US) a été supprimé de l'attribut MediaSource.sourceBuffers (en-US) de sa source média parent.

Notes d'utilisation

Pour obtenir un VideoTrack pour un élément multimédia donné, utilisez la propriété videoTracks (en-US), qui renvoie un objet VideoTrackList (en-US) à partir duquel vous pouvez obtenir les pistes individuelles contenues dans le média:

var el = document.querySelector("video");
var tracks = el.videoTracks;

Vous pouvez ensuite accéder aux pistes individuelles du média en utilisant soit la syntaxe de tableau, soit des fonctions telles que forEach().

Ce premier exemple obtient la première piste vidéo sur le média:

var firstTrack = tracks[0];

L'exemple suivant parcourt toutes les pistes vidéo du média, activant la première piste vidéo qui est dans la langue préférée de l'utilisateur (tirée d'une variable userLanguage).

for (var i = 0; i < tracks.length; i++) {
  if (tracks[i].language === userLanguage) {
    tracks[i].selected = true;
    break;
  }
});

Le language (en-US) est au format standard (RFC 5646). Pour l'anglais américain, ce serait "en-US", par exemple.

Spécifications

Spécification Statut Commentaire
HTML Living Standard
La définition de 'VideoTrack' dans cette spécification.
Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser