L'interfaceHTMLMediaElement ajoute àHTMLElement les propriétés et les méthodes nécessaires pour prendre en charge les fonctionnalités de base liées aux médias qui sont communes aux vidéos et aux documents audios.HTMLVideoElement etHTMLAudioElement héritent de cette interface.

Propriétés

Cette interface hérite aussi des propriétés de ses ancêtresHTMLElement,Element,Node etEventTarget.

HTMLMediaElement.audioTracks

est uneAudioTrackList qui liste les objetsAudioTrack (pistes audio) contenus dans l'élément.

HTMLMediaElement.autoplay

est unBoolean qui reflète l'attribut HTMLautoplay, indiquant si la lecture doit commencer automatiquement dès que suffisamment de médias sont disponibles pour le faire sans interruption.

Note :Les sites qui lisent automatiquement l'audio (ou les vidéos avec une piste audio) peuvent être désagréables pour les utilisateurs, il faut donc l'éviter autant que possible. Si vous devez offrir la fonctionnalité de lecture automatique, vous devez la faire activer (par un utilisateur qui la lance expréssement). Cependant, cela peut être utile lors de la création d'éléments média dont la source sera définie ultérieurement, sous le contrôle de l'utilisateur.

HTMLMediaElement.bufferedLecture seule

Renvoie un objetTimeRanges qui indique les plages de la source du média que le navigateur a en mémoire tampon (le cas échéant) au moment de l'accès à la propriétébuffered.

HTMLMediaElement.controller

est un objetMediaController qui représente le contrôleur du média assigné à l'élément, ounull si aucun n'est défini.

HTMLMediaElement.controls

est unBoolean qui reflète l'attribut HTMLcontrols, indiquant quels éléments de contrôle de ressource de l'interface utilisateur doivent être affichés.

HTMLMediaElement.controlsListLecture seule

renvoie uneDOMTokenList qui aide l'agent utilisateur à sélectionner les contrôles à afficher sur l'élément du média chaque fois que l'agent utilisateur affiche son propre jeu de contrôles. LaDOMTokenList prend une ou plusieurs des trois valeurs possibles :nodownload,nofullscreen etnoremoteplayback.

HTMLMediaElement.crossOrigin

est uneDOMString (chaîne de caractères) indiquant lesrèglages CORS pour cet élément de média.

HTMLMediaElement.currentSrcLecture seule

Renvoie uneDOMString (chaîne de caractères) avec l'URL absolue de la ressource de média choisie.

HTMLMediaElement.currentTime

est undouble indiquant le temps de lecture actuel en secondes. La définition de cette valeur recherche le média à la nouvelle heure.

HTMLMediaElement.defaultMuted

est unBoolean qui reflète l'attribut HTMLmuted, qui indique si la sortie audio de l'élément média doit être désactivée par défaut.

HTMLMediaElement.defaultPlaybackRate

est undouble indiquant le taux de lecture par défaut pour le média.

HTMLMediaElement.disableRemotePlayback

est unBoolean qui définit ou retourne l'état de lecture à distance, indiquant si l'élément de média est autorisé à avoir une interface de lecture à distance.

HTMLMediaElement.durationLecture seule

renvoie undouble indiquant la longueur du média en secondes, ou 0 si aucune donnée multimédia n'est disponible.

HTMLMediaElement.endedLecture seule

renvoie unBoolean qui indique si l'élément média est terminé.

HTMLMediaElement.errorLecture seule

renvoie un objetMediaError pour l'erreur la plus récente, ounull s'il n'y a pas eu d'erreur.

HTMLMediaElement.loop

est unBoolean qui reflète l'attribut HTMLloop (boucle), lequel indique si l'élément média doit recommencer quand il arrive à la fin.

HTMLMediaElement.mediaGroup

est uneDOMString qui reflète l'attribut HTMLmediagroup, lequel indique le nom du groupe d'éléments auquel il appartient. Un groupe d'éléments média partage unMediaController commun.

HTMLMediaElement.mediaKeysLecture seuleExpérimental

Renvoie un objetMediaKeys ounull.MediaKeys est un ensemble de clés qu'un élémentHTMLMediaElement associé peut utiliser pour déchiffrer les données du média pendant la lecture.

HTMLMediaElement.mozAudioCapturedLecture seuleNon standard

renvoie unBoolean. Lié à la capture de flux audio.

HTMLMediaElement.mozFragmentEndNon standard

est undouble qui donne accès à l'heure de fin du fragment si l'élément média a un fragment URI pourcurrentSrc, sinon il est égal à la durée du média.

HTMLMediaElement.mozFrameBufferLengthNon standardObsolète

est ununsigned long qui indique le nombre d'échantillons qui seront renvoyés dans le "framebuffer" de chaque évènementMozAudioAvailable. Ce nombre est un total pour tous les canaux, et par défaut est défini par le nombre de canaux * 1024 (c'est-à-dire, 2 canaux * 1024 échantillons = total 2048).

La propriétémozFrameBufferLength peut être définie à une nouvelle valeur pour une latence plus faible, de plus grandes quantités de données, etc. La taille donnéedoit être un nombre compris entre 512 et 16384. L'utilisation d'autres tailles entraîne la levée d'une exception. Le meilleur moment pour définir une nouvelle longueur est après le lancement de l'évènementloadedmetadata, lorsque l'information audio est connue, mais avant que l'audio ait commencé ou que les événementsMozAudioAvailable aient commencé à se déclencher.

HTMLMediaElement.mozSampleRateLecture seuleNon standardObsolète

renvoie undouble représentant le nombre d'échantillons par seconde. Par exemple, 44100 échantillons par seconde correspondent à la fréquence d'échantillonnage utilisée par les CD audio.

HTMLMediaElement.muted

est unBoolean qui détermine si l'audio est coupé.true (vrai) si l'audio est coupé etfalse (faux) sinon.

HTMLMediaElement.networkStateLecture seule

renvoie ununsigned short (énumération) indiquant l'état actuel de récupération du média sur le réseau.

HTMLMediaElement.pausedLecture seule

renvoie unBoolean qui indique si l'élément média est en pause.

HTMLMediaElement.playbackRate

est undouble qui indique la vitesse à laquelle le média est lu.

HTMLMediaElement.playedLecture seule

renvoie un objetTimeRanges qui contient les plages de la source média que le navigateur a lu, le cas échéant.

HTMLMediaElement.preload

est uneDOMString (chaîne) qui reflète l'attribut HTMLpreload, indiquant quelles données doivent être préchargées, le cas échéant. Les valeurs possibles sont :none,metadata,auto.

HTMLMediaElement.preservesPitchNon standard

est unBoolean qui détermine si la hauteur du son sera préservée. S'il est défini àfalse (faux), la hauteur du son s'ajustera à la vitesse de l'audio. C'est implémenté avec préfixe dans Firefox (mozPreservesPitch) et WebKit (webkitPreservesPitch).

HTMLMediaElement.readyStateLecture seule

Renvoie ununsigned short (énumération) indiquant l'état de préparation des médias.

HTMLMediaElement.seekableLecture seule

Renvoie un objetTimeRanges qui contient les plages de temps que l'utilisateur peut rechercher, le cas échéant.

HTMLMediaElement.seekingLecture seule

Renvoie unBoolean qui indique si les médias sont en train de chercher une nouvelle position.

HTMLMediaElement.sinkIdLecture seuleExpérimental

Renvoie uneDOMString (chaîne) qui est l'identifiant unique du périphérique audio de sortie, ou une chaîne vide s'il utilise l'agent utilisateur par défaut. Cet identifiant doit être l'une des valeursMediaDeviceInfo.deviceid retournées parMediaDevices.enumeratedDevices(),id-multimedia ouid-communications.

HTMLMediaElement.src

est uneDOMString qui reflète l'attribut HTMLsrc, lequel contient l'URL d'une ressource média à utiliser.

HTMLMediaElement.srcObject

est unMediaStream représentant le média à lire ou qui a joué dans leHTMLMediaElement courant, ounull s'il n'est pas assigné.

HTMLMediaElement.textTracksLecture seule

Renvoie la liste d'objetsTextTrack (piste de texte) contenus dans l'élément.

HTMLMediaElement.videoTracksLecture seule

Renvoie la liste d'objetsVideoTrack (pistes vidéo) contenus dans l'élément.

Note :Gecko ne prend en charge que la lecture d'une seule piste et l'analyse des métadonnées des pistes n'est disponible que pour les médias avec le format de conteneur Ogg.

HTMLMediaElement.volume

est undouble indiquant le volume audio, de 0.0 (silence) à 1.0 (le plus fort).

Gestionnaires d'évènements

HTMLMediaElement.onencrypted

définit leEventHandler (gestionnaire d'évènements) appelé quand le média est encrypté.

HTMLMediaElement.onwaitingforkey

définit leEventHandler (gestionnaire d'évènements) appelé quand la lecture est bloquée en attente d'une clé de chiffrement.

Attributs obsolètes

Ces attributs sont obsolètes et ne doivent plus être utilisés, même si un navigateur les prend encore en charge.

HTMLMediaElement.initialTimeLecture seuleNon standardObsolète

renvoie undouble qui indique la position de lecture initiale en secondes.

HTMLMediaElement.mozChannelsLecture seuleNon standardObsolète

renvoie undouble représentant le nombre de canaux dans la ressource audio (c'est-à-dire 2 pour stéréo).

Gestionnaires d'évènements obsolètes

HTMLMediaElement.onmozinterruptbeginNon standardObsolète

définit le gestionnaire d'évènement appelé lorsque l'élément média est interrompu du fait du gestionnaire de canaux audio. C'était une spécificité de Firefox, implémentée pour Firefox OS et supprimée à partir de Firefox 55.

HTMLMediaElement.onmozinterruptendNon standardObsolète

définit le gestionnaire d'évènement appelé lorsque l'interruption est terminée. C'était une spécificité de Firefox, implémentée pour Firefox OS et supprimée à partir de Firefox 55.

Méthodes

Cette interface hérite aussi des méthodes de ses ancêtresHTMLElement,Element,Node etEventTarget.

HTMLMediaElement.addTextTrack()

Ajoute une piste de texte (telle qu'une piste pour les sous-titres) à un élément de média.

HTMLMediaElement.captureStream()Expérimental

RenvoieMediaStream, capture un flux du contenu du média.

HTMLMediaElement.canPlayType()

Détermine si le type de média spécifié peut être lu.

HTMLMediaElement.fastSeek()

cherche directement à l'heure donnée.

HTMLMediaElement.load()

Réinitialise l'élément média et redémarre la ressource. Tous les événements en attente sont ignorés. La quantité de données média récupérées est toujours affectée par l'attributpreload. Cette méthode peut être utile pour libérer des ressources après la suppression de tout attributsrc et des descendants d'élémentssource. Sinon, il est généralement inutile d'utiliser cette méthode, à moins que cela ne soit nécessaire pour réanalyser les enfants de l'élémentsource après des modifications dynamiques.

HTMLMediaElement.mozCaptureStream()Non standard

[enter description]

HTMLMediaElement.mozCaptureStreamUntilEnded()Non standard

[enter description]

HTMLMediaElement.mozGetMetadata()Non standard

Renvoie unObject, qui contient des propriétés représentant les métadonnées de la ressource média en cours de lecture, comme paires{key: value}. Une copie distincte des données est renvoyée chaque fois que la méthode est appelée. Cette méthode doit être appelée après le déclenchement de l'évènementloadedmetadata.

HTMLMediaElement.pause()

met en pause la lecture du média.

HTMLMediaElement.play()

commence la lecture du média.

HTMLMediaElement.seekToNextFrame()Non standardExpérimental

cherche l'image suivante dans les médias. Cette méthode expérimentale non standard permet de conduire manuellement la lecture et le rendu des médias à une vitesse personnalisée, ou de se déplacer dans le média image par image pour effectuer un filtrage ou d'autres opérations.

HTMLMediaElement.setMediaKeys()Expérimental

RenvoiePromise. Définit lesMediaKeys, clés à utiliser quand le média doit être décrypté pendant la lecture.

HTMLMediaElement.setSinkId()Expérimental

définit l'identifiant du périphérique audio à utiliser en sortie et renvoie unPromise. Cela fonctionne uniquement quand l'application est autorisée à utiliser l'appareil spécifié.

Méthodes obsolètes

Ces méthodes sont obsolètes et ne doivent plus être utilisées, même si un navigateur les prend encore en charge.

HTMLMediaElement.mozLoadFrom()Non standardObsolète

Cette méthode, disponible seulement pour les implémentations Mozilla, charge les données d'un autre élément de média. Ce fonctionnement est similaire àload() excepté qu'à la place d'exécuter l'algorithme normal de sélection de la ressource, la source est simplement définie surcurrentSrc de l'autre élément. Ceci est optimisé pour que cet élément accède à toutes les données mises en cache et en mémoire tampon de l'autre élément ; en fait, les deux éléments partagent les données téléchargées, de sorte que les données téléchargées par l'un ou l'autre élément sont disponibles pour les deux.

Spécifications

Compatibilité des navigateurs

Voir aussi

• References

  • Les éléments HTML<video> et<audio>.
  • Les interfacesHTMLVideoElement etHTMLAudioElement, dérivées deHTMLMediaElement.

• Articles

  • Contenu audio et video
  • Formats pris en charge paraudio etvideo
  • Web Audio API