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 afin d'en faire la piste vidéo active pour l'élément <video>.

Propriétés

selected
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(). 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 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 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 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 Lecture seule
Le SourceBuffer qui a créé la piste. Renvoie null si la piste n'a pas été créée par un SourceBuffer ou le SourceBuffer a été supprimé de l'attribut MediaSource.sourceBuffers 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, qui renvoie un objet VideoTrackList à 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 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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
VideoTrackChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
idChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
kindChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
labelChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
languageChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
selectedChrome Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Support complet 10Opera Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 37
Désactivée
Support complet 37
Désactivée
Désactivée From version 37: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Support complet 33
Désactivée
Support complet 33
Désactivée
Désactivée From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 24
Désactivée
Support complet 24
Désactivée
Désactivée From version 24: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non
sourceBufferChrome Support complet 51
Désactivée
Support complet 51
Désactivée
Désactivée From version 51: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Edge Support complet 79
Désactivée
Support complet 79
Désactivée
Désactivée From version 79: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Aucun support 12 — 79
Firefox Aucun support NonIE Aucun support NonOpera Support complet 38
Désactivée
Support complet 38
Désactivée
Désactivée From version 38: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari Support complet 6.1WebView Android Aucun support NonChrome Android Support complet 51
Désactivée
Support complet 51
Désactivée
Désactivée From version 51: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled). To change preferences in Chrome, visit chrome://flags.
Firefox Android Aucun support NonOpera Android Support complet 41
Désactivée
Support complet 41
Désactivée
Désactivée From version 41: this feature is behind the enable-experimental-web-platform-features preference (needs to be set to enabled).
Safari iOS Support complet 7Samsung Internet Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.