API MediaStream

L'API Processing MediaStream, souvent appelée Media Stream API ou Stream API, est la partie de WebRTC décrivant un flux de données audio ou vidéo, les méthodes pour les manipuler, les contraintes associées au type de données, les erreurs et succès des callbacks avec les données asynchrones, et les évènements déclenchés durant le processus.

Concepts de base

L'API est basée sur la manipulation de l'objet MediaStream représentant un flux de données audio ou vidéo. Typiquement, un MediaStream est une simple chaine URL qui peut être utilisée pour référencer une donnée stockée dans un File DOM, ou un objet Blob crée avec window.URL.createObjectURL(), tel que décrit dans cette vidéo.

Un MediaStream consiste en zéro ou plus objets MediaStreamTrack, représentant différentes pistes audio ou vidéos. Chaque MediaStreamTrack peut avoir un ou plusieurs canal. Le canal représente la plus petite unité d'un flux média, tel un signal audio d'un haut-parleur, séparé en gauche et droite sur une piste audio en stéréo.

Les objets MediaStream ont une seule entrée et une seule sortie. Un objet MediaStream généré par getUserMedia() est dit local, et sa source d'entrée provient de l'une des caméras ou des microphones de l'utilisatrice ou l'utilisateur. Un objet MediaStream non local peut représenter un média tel que <video> ou <audio>, un flux provenant du réseau et obtenu via l'API WebRTC RTCPeerConnection, ou un flux créé en utilisant l'API Web Audio MediaStreamAudioDestinationNode.

La sortie d'un objet MediaStream est liée à un consommateur. Elle peut être un élément média tel que <audio> ou <video>, l'API WebRTC RTCPeerConnection ou l'API Web Audio MediaStreamAudioDestinationNode.

Interfaces

Dans ces articles de référence, on trouvera les informations fondamentales sur les différentes interfaces qui composent l'API Media Capture and Streams API.

Les premières versions de la spécification pour Media Capture and Streams API incluaient des interfaces séparées AudioStreamTrack et VideoStreamTrack, chacunes basées sur MediaStreamTrack et qui représentaient des types de flux différents. Celles-ci n'existent plus et il faut utiliser MediaStreamTrack directement à la place.

Évènements

Guides et tutorials

Les articles qui suivent fournissent des manuels et guides pour utiliser cette API et réaliser des certaines tâches avec elle.

Prendre des photos avec getUserMedia()

Dans cet article, nous verrons comment utiliser navigator.mediaDevices.getUserMedia() pour accéder à la caméra de votre ordinateur ou de votre téléphone afin de prendre des photos avec.

Compatibilité des navigateurs

api.MediaStream

BCD tables only load in the browser

api.MediaStreamTrack

BCD tables only load in the browser

api.MediaDevices

BCD tables only load in the browser

api.MediaDeviceInfo

BCD tables only load in the browser

api.InputDeviceInfo

BCD tables only load in the browser

api.CanvasCaptureMediaStreamTrack

BCD tables only load in the browser

Voir aussi