MediaStreamTrack

Você está lendo a versão em inglês deste conteúdo porque ainda não há uma tradução para este idioma. Ajude-nos a traduzir este artigo!

Resumo

A interface MediaStream representa uma stream de conteúdo de mídia. Uma stream consiste em várias tracks, como faixas de áudio e vídeo.

Properties

MediaStreamTrack.enabled

Is a Boolean value with a value of true if the track is enabled, that is allowed to render the media source stream; or false if it is disabled, that is not rendering the media source stream but silence and blackness. If the track has been disconnected, this value can be changed but has no more effect.

MediaStreamTrack.id Somente leitura

Returns a DOMString containing a unique identifier (GUID) for the track; it is generated by the browser.

MediaStreamTrack.kind Somente leitura

Returns a DOMString set to "audio" if the track is an audio track and to "video", if it is a video track. It doesn't change if the track is deassociated from its source.

MediaStreamTrack.label Somente leitura

Returns a DOMString containing a user agent-assigned label that identifies the track source, as in "internal microphone". The string may be left empty and is empty as long as no source has been connected. When the track is deassociated from its source, the label is not changed.

MediaStreamTrack.muted Somente leitura

Returns a Boolean value with a value of true if the track is muted, false otherwise.

MediaStreamTrack.readonly Somente leitura

Returns a Boolean value with a value of true if the track is readonly (such a video file source or a camera that settings can't be modified),false otherwise.

MediaStreamTrack.readyState Somente leitura

Returns an enumerated value giving the status of the track.It takes one of the following values:

"live" which indicates that an input is connected and does its best-effort in providing real-time data. In that case, the output of data can be switched on or off using the MediaStreamTrack.enabled attribute.
"ended" which indicates that the input is not giving any more data and will never provide new data.

MediaStreamTrack.remote Somente leitura

Returns a boolean value with a value of true if the track is sourced by a RTCPeerConnection, false otherwise.

Event handlers

MediaStreamTrack.onstarted: Is a EventHandler containing the action to perform when an started event is fired on the object, that is when a new MediaStreamTrack object is added.
MediaStreamTrack.onmute: Is a EventHandler containing the action to perform when an mute event is fired on the object, that is when the streaming is terminating.
MediaStreamTrack.onunmute: Is a EventHandler containing the action to perform when an unmute event is fired on the object, that is when a MediaStreamTrack object is removed from it.
MediaStreamTrack.onoverconstrained: Is a EventHandler containing the action to perform when an overconstrained event is fired on the object, that is when a MediaStreamTrack object is removed from it.
MediaStreamTrack.oneended: Is a EventHandler containing the action to perform when an ended event is fired on the object, that is when a MediaStreamTrack object is removed from it.

Methods

MediaStreamTrack.getConstraints()
MediaStreamTrack.applyConstraints()
MediaStreamTrack.getSettings()
MediaStreamTrack.getCapabilities()
MediaStreamTrack.clone()
MediaStreamTrack.stop(): Stops playing the source associated to the track, both the source and the track are deassociated. The track state is set to ended.

Specifications

Specification	Status	Comment
Media Capture and Streams The definition of 'MediaStreamTrack' in that specification.	Candidata a Recomendação	Initial definition

Browser compatibility

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Desktop
Dispositivo móvel

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	(Yes)	(Yes)	Não suportado	Não suportado	?
`stop()`	?	34 (34)	?	?	?
`muted`, `onmuted`, `onunmuted`, `readonly`, `readyState`, `remote`, `onstarted`, `onended`, `onoverconstrained`, `appendConstraint()`, `applyConstraints()`, `constraints()`, `getConstraints()`	?	Não suportado	Não suportado	Não suportado	?

Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile

Basic support ? (Yes) Não suportado Não suportado ?

stop()

34 (34)

muted, onmuted, onunmuted, readonly, readyState, remote, onstarted, onended, onoverconstrained, appendConstraint(), applyConstraints(), constraints(), getConstraints() ? Não suportado Não suportado Não suportado ?