In addition to the properties listed below, MediaStreamTrack
has constrainable properties which can be set using Capabilities, constraints, and settings to learn how to correctly work with constrainable properties. Not doing so correctly will result in your code being unreliable.
MediaStreamTrack.contentHint
-
A string that may be used by the web application to provide a hint as to what type of content the track contains to guide how it should be treated by API consumers. Allowable values depend on the value of the
MediaStreamTrack.kind
property. MediaStreamTrack.enabled
-
A Boolean whose 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.Note: You can implement standard "mute" functionality by setting
enabled
tofalse
. Themuted
property refers to a condition in which there's no media because of a technical issue. MediaStreamTrack.id
Read only-
Returns a string containing a unique identifier (GUID) for the track; it is generated by the browser.
MediaStreamTrack.kind
Read only-
Returns a string 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 disassociated from its source. MediaStreamTrack.label
Read only-
Returns a string 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 disassociated from its source, the label is not changed. MediaStreamTrack.muted
Read only-
Returns a Boolean value indicating whether the track is unable to provide media data due to a technical issue.
Note: You can implement standard "mute" functionality by setting
enabled
tofalse
, and unmute the media by setting it back totrue
again. MediaStreamTrack.readyState
Read only-
Returns an enumerated string giving the status of the track. This will be 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 theenabled
attribute."ended"
which indicates that the input is not giving any more data and will never provide new data.