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éra ou microphone de 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 PeerConnection, ou un flux créé en utilisant l'API Web Audio MediaStreamAudioSourceNode
. 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 PeerConnection 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.
There are no subpages at this time.
Compatibilité des navigateurs
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()
.