From a8587a9d394e09f0520c9d321329254f3cb484f0 Mon Sep 17 00:00:00 2001 From: Jan-Ivar Bruaroey Date: Thu, 25 Apr 2024 18:25:10 -0400 Subject: [PATCH 1/3] Remove redundant statements about muted/enabled. --- getusermedia.html | 45 ++++++++------------------------------------- 1 file changed, 8 insertions(+), 37 deletions(-) diff --git a/getusermedia.html b/getusermedia.html index 2a02151e..f579e0c6 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -828,10 +828,10 @@

Media Flow

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.

+ 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.

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 @@ -846,16 +846,10 @@

Life-cycle

new ended track. The current state is reflected by the object's {{MediaStreamTrack/readyState}} attribute.

-

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).

-

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.

+

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.

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 @@ -896,29 +890,6 @@

Life-cycle

simultaneously may interfere with this intent at times, they do not interfere with the rules laid forth.

-

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.

-

A {{MediaStreamTrack}} is [= MediaStreamTrack/muted =] - when the source is muted, 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=].

-

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.

-

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.

A {{MediaStreamTrack}} object is said to end when the source of the track is disconnected or exhausted.

From d4488c86fb7bf2c42dafd738767bf9d724a7dc22 Mon Sep 17 00:00:00 2001 From: Jan-Ivar Bruaroey Date: Thu, 25 Apr 2024 18:56:38 -0400 Subject: [PATCH 2/3] Incorporate [=source/muted=] definition from other section. --- getusermedia.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/getusermedia.html b/getusermedia.html index f579e0c6..44ccc97c 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -767,7 +767,9 @@

Media Flow

muted, and enabled / disabled.

Muted 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 muted. + Live samples MUST NOT be made available to a {{MediaStreamTrack}} while it is [=MediaStreamTrack/muted=].

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 From 57650c847f91af19db9782c09e5d2238c732dcd5 Mon Sep 17 00:00:00 2001 From: Jan-Ivar Bruaroey Date: Fri, 17 May 2024 15:18:56 -0400 Subject: [PATCH 3/3] keep "i.e. temporarily unable to provide the track with data" --- getusermedia.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/getusermedia.html b/getusermedia.html index 44ccc97c..17a89d8c 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -768,7 +768,8 @@

Media Flow

Muted refers to the input to the {{MediaStreamTrack}}. A {{MediaStreamTrack}} is [= MediaStreamTrack/muted =] - when its source is muted. + when its source is muted, + 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=].

The [=MediaStreamTrack/muted=] state is outside the control of web applications, but can be observed by