MediaStreamTrack
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
(en-US)-
Is a Boolean value with a value of
true
if the track is enabled, that is allowed to render the media source stream; orfalse
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
(en-US) Somente leitura-
Returns a
DOMString
containing a unique identifier (GUID) for the track; it is generated by the browser. MediaStreamTrack.kind
(en-US) 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
(en-US) 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
(en-US) 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
(en-US) 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 theMediaStreamTrack.enabled
attribute."ended"
which indicates that the input is not giving any more data and will never provide new data.
MediaStreamTrack.remote
(en-US) Somente leitura-
Returns a boolean value with a value of
true
if the track is sourced by aRTCPeerConnection
,false
otherwise.
Event handlers
MediaStreamTrack.onstarted
-
Is a
event handler
containing the action to perform when anstarted
event is fired on the object, that is when a newMediaStreamTrack
object is added. MediaStreamTrack.onmute
(en-US)-
Is a
event handler
containing the action to perform when anmute
event is fired on the object, that is when the streaming is terminating. MediaStreamTrack.onunmute
(en-US)-
Is a
event handler
containing the action to perform when anunmute
event is fired on the object, that is when aMediaStreamTrack
object is removed from it. MediaStreamTrack.onoverconstrained
(en-US)-
Is a
event handler
containing the action to perform when anoverconstrained
event is fired on the object, that is when aMediaStreamTrack
object is removed from it. MediaStreamTrack.oneended
-
Is a
event handler
containing the action to perform when anended
event is fired on the object, that is when aMediaStreamTrack
object is removed from it.
Methods
MediaStreamTrack.getConstraints()
(en-US)-
…
MediaStreamTrack.applyConstraints()
(en-US)-
…
MediaStreamTrack.getSettings()
(en-US)-
…
MediaStreamTrack.getCapabilities()
(en-US)-
…
MediaStreamTrack.clone()
(en-US)-
…
MediaStreamTrack.stop()
(en-US)-
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
BCD tables only load in the browser