--- title: API de Captura de Transmissões de Multimédia (Media Streams) slug: Web/API/API_transmissoes_multimedia tags: - API - API de Transmissão de Multimédia - Audio - Avançado - Guía - Introdução - Media - Multimedia - Video translation_of: Web/API/Media_Streams_API ---
A API de Media Capture and Streams, muitas vezes chamada de Media Stream API ou Stream API, é uma API relacionada com WebRTC que suporta transmissões de dados de áudio ou vídeo, os métodos para trabalhar com eles, as restrições associadas com o tipo de dados, as devoluções de retorno de sucesso e erro quando utilizar os dados de forma assíncrona, e os eventos que foram ativados durante o processo.
The API is based on the manipulation of a {{domxref("MediaStream")}} object representing a flux of audio- or video-related data. See an example in Get the video.
A MediaStream
consists of zero or more {{domxref("MediaStreamTrack")}} objects, representing various audio or video tracks. Each MediaStreamTrack
may have one or more channels. The channel represents the smallest unit of a media stream, such as an audio signal associated with a given speaker, like left or right in a stereo audio track.
MediaStream
objects have a single input and a single output. A MediaStream
object generated by {{domxref("MediaDevices.getUserMedia", "getUserMedia()")}} is called local, and has as its source input one of the user's cameras or microphones. A non-local MediaStream
may be representing to a media element, like {{HTMLElement("video")}} or {{HTMLElement("audio")}}, a stream originating over the network, and obtained via the WebRTC {{domxref("RTCPeerConnection")}} API, or a stream created using the Web Audio API {{domxref("MediaStreamAudioSourceNode")}}. The output of the MediaStream
object is linked to a consumer. It can be a media elements, like {{HTMLElement("audio")}} or {{HTMLElement("video")}}, the WebRTC {{domxref("RTCPeerConnection")}} API or a Web Audio API {{domxref("MediaStreamAudioDestinationNode")}}.
{{LandingPageListSubpages}}
{{ CompatibilityTable }}
Funcionalidade | Chrome | Firefox (Gecko) | Edge | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Stream API | 21{{ property_prefix("webkit") }} | Nightly 18{{ property_prefix("moz") }} | {{ CompatVersionUnknown }} | {{ CompatUnknown }} | 12 | {{ CompatUnknown }} |
Funcionalidade | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
API de emissão | {{ CompatNo }} | {{CompatVersionUnknown}} | {{ CompatUnknown }} | {{ CompatUnknown }} | {{ CompatNo }} | {{ CompatNo }} |
Currently using WebRTC for accessing the camera is supported in Chrome, Opera and Firefox Nightly 18. Enabling WebRTC in Firefox Nightly requires you to set a flag in the configuration:
getUserMedia()
.