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.
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é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
- WebRTC - la page d'introduction à l'API
mediaDevices.getUserMedia()
- Prendre des clichés avec WebRTC : un tutoriel/une démonstration sur l'utilisation de
getUserMedia()
.