L'API Processing MediaStream, souvent appeléeMedia Stream API ouStream API, est la partie deWebRTC 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'objetMediaStream représentant un flux de données audio ou vidéo. Typiquement, unMediaStream est une simple chaine URL qui peut être utilisée pour référencer une donnée stockée dans unFile DOM, ou un objetBlob crée avecwindow.URL.createObjectURL(), tel que décrit danscette vidéo.

UnMediaStream consiste en zéro ou plus objetsMediaStreamTrack, représentant différentespistes audio ou vidéos. ChaqueMediaStreamTrack peut avoir un ou plusieurscanal. Le canal représente la plus petite unité d'un flux média, tel un signal audio d'un haut-parleur, séparé engauche etdroite sur une piste audio en stéréo.

Les objetsMediaStream ont une seuleentrée et une seulesortie. Un objetMediaStream généré pargetUserMedia() est ditlocal, et sa source d'entrée provient de l'une des caméras ou des microphones de l'utilisatrice ou l'utilisateur. Un objetMediaStream non local peut représenter un média tel que<video> ou<audio>, un flux provenant du réseau et obtenu via l'API WebRTCRTCPeerConnection, ou un flux créé en utilisant l'APIWeb AudioMediaStreamAudioDestinationNode.

La sortie d'un objetMediaStream est liée à unconsommateur. Elle peut être un élément média tel que<audio> ou<video>, l'API WebRTCRTCPeerConnection ou l'APIWeb AudioMediaStreamAudioDestinationNode.

Interfaces

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

• BlobEvent
• CanvasCaptureMediaStreamTrack
• InputDeviceInfo
• MediaDeviceKind
• MediaDeviceInfo
• MediaDevices
• MediaStream
• MediaStreamConstraints
• MediaStreamEvent
• MediaStreamTrack
• MediaStreamTrackEvent
• MediaTrackCapabilities
• MediaTrackConstraints
• MediaTrackSettings
• MediaTrackSupportedConstraints
• NavigatorUserMedia
• NavigatorUserMediaError
• OverconstrainedError
• URL

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

Évènements

• addtrack
• ended
• mute
• overconstrained
• removetrack
• unmute

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 utilisernavigator.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

api.MediaStreamTrack

api.MediaDevices

api.MediaDeviceInfo

api.InputDeviceInfo

api.CanvasCaptureMediaStreamTrack

Voir aussi

• WebRTC - la page d'introduction à l'API
• mediaDevices.getUserMedia()
• Prendre des clichés avec WebRTC : un tutoriel/une démonstration sur l'utilisation degetUserMedia().