Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove redundant statements about muted/enabled. #998

Merged
merged 3 commits into from
May 30, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 12 additions & 38 deletions getusermedia.html
Original file line number Diff line number Diff line change
Expand Up @@ -767,7 +767,10 @@ <h4>Media Flow</h4>
muted, and enabled / disabled.</p>
<p><dfn class="export" data-dfn-for="MediaStreamTrack" data-dfn-type="dfn" id=
"track-muted">Muted</dfn> refers to the input to the
{{MediaStreamTrack}}. Live samples MUST NOT be made available to a
{{MediaStreamTrack}}. A {{MediaStreamTrack}} is [= MediaStreamTrack/muted =]
when its source is <dfn data-dfn-for="source">muted</dfn>,
i.e. temporarily unable to provide the track with data.
Live samples MUST NOT be made available to a
{{MediaStreamTrack}} while it is [=MediaStreamTrack/muted=].</p>
<p>The [=MediaStreamTrack/muted=] state is outside the control of web applications, but can be observed by
the application by reading the {{MediaStreamTrack/muted}} attribute and listening
Expand Down Expand Up @@ -828,10 +831,10 @@ <h4>Media Flow</h4>
consumer gets zero-information-content, which means silence for audio
and black frames for video. In other words, media from the source only
flows when a {{MediaStreamTrack}} object is both
unmuted and enabled. For example, a video element sourced by a muted or
disabled {{MediaStreamTrack}} (contained in a
{{MediaStream}} ), is playing but rendering
blackness.</p>
unmuted and enabled. For example, a video element sourced by a
{{MediaStream}} containing only muted or disabled {{MediaStreamTrack}}s
for audio and video, is playing but rendering black video frames in
silence.</p>
<p>For a newly created {{MediaStreamTrack}} object, the
following applies: the track is always enabled unless stated otherwise
(for example when cloned) and the muted state reflects the state of the
Expand All @@ -846,16 +849,10 @@ <h4>Life-cycle</h4>
new ended track. The current state is reflected by the object's
{{MediaStreamTrack/readyState}}
attribute.</p>
<p>In the live state, the track is active and media is
available for use by consumers (but may be replaced by
zero-information-content if the {{MediaStreamTrack}} is
[= MediaStreamTrack/muted =] or [= MediaStreamTrack/enabled | disabled =], see below).</p>
<p>A muted or disabled {{MediaStreamTrack}} renders
either silence (audio), black frames (video), or a
zero-information-content equivalent. For example, a video element
sourced by a muted or disabled {{MediaStreamTrack}}
(contained within a {{MediaStream}} ), is playing but
the rendered content is the muted output.</p>
<p>In the live state, the track is active and media
(or zero-information-content if the {{MediaStreamTrack}} is
[= MediaStreamTrack/muted =] or [= MediaStreamTrack/enabled | disabled =])
is available for use by consumers.</p>
<p>If the source is a device exposed by `navigator.mediaDevices.`{{MediaDevices/getUserMedia()}},
then when a track becomes either
muted or disabled, and this brings all tracks connected to the device
Expand Down Expand Up @@ -896,29 +893,6 @@ <h4>Life-cycle</h4>
simultaneously may interfere with this intent at times, they do not
interfere with the rules laid forth.</p>
</div>
<p>The muted/unmuted state of a track reflects whether the source
provides any media at this moment. The enabled/disabled state is under
application control and determines whether the track outputs media (to
its consumers). Hence, media from the source only flows when a
{{MediaStreamTrack}} object is both unmuted and
enabled.</p>
<p>A {{MediaStreamTrack}} is [= MediaStreamTrack/muted =]
jan-ivar marked this conversation as resolved.
Show resolved Hide resolved
when the source is <dfn data-dfn-for="source">muted</dfn>, i.e. temporarily unable to
provide the track with data. A track can be muted by a user. Often this
action is outside the control of the application. This could be as a
result of the user hitting a hardware switch or toggling a control in
the operating system / [=User Agent=] chrome. A track can also be muted by the
[=User Agent=].</p>
<p>Applications are able to [= MediaStreamTrack/enabled | enable =] or
disable a {{MediaStreamTrack}} to prevent it from
rendering media from the source. A muted track will however, regardless
of the enabled state, render silence and blackness. A disabled track is
logically equivalent to a muted track, from a consumer point of
view.</p>
<p>For a newly created {{MediaStreamTrack}} object, the
following applies. The track is always enabled unless stated otherwise
(for example when cloned) and the muted state reflects the state of the
source at the time the track is created.</p>
<p>A {{MediaStreamTrack}} object is said to
<em>end</em> when the source of the track is disconnected or
exhausted.</p>
Expand Down