From 7e990b683ee981e17c81d54a8dc1230ca8bac4dc Mon Sep 17 00:00:00 2001
From: Elad Alon <eladalon@google.com>
Date: Fri, 24 Nov 2023 13:43:15 +0100
Subject: [PATCH 1/2] Define getMuteReasons()

---
 getusermedia.html | 59 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/getusermedia.html b/getusermedia.html
index 0874d7d6..0a871199 100644
--- a/getusermedia.html
+++ b/getusermedia.html
@@ -642,6 +642,12 @@ <h2>{{MediaStreamTrack}}</h2>
               initialized to <code>true</code> if <var>source</var> is
               [= muted =], and <code>false</code> otherwise.</p>
             </li>
+            <li>
+              <p><dfn>[[\MuteReasons]]</dfn></p>
+              <p>
+                TODO: Decide whether this replaces {{MediaStreamTrack/[[Muted]]}}
+                or goes alongside it.
+              </p>
             <li>
               <a data-link-for="constrainable object"
                  data-link-type="attribute">[[\Capabilities]]</a>,
@@ -999,6 +1005,7 @@ <h3>Interface Definition</h3>
   undefined stop();
   MediaTrackCapabilities getCapabilities();
   MediaTrackConstraints getConstraints();
+  sequence&lt;MuteReason&gt; getMuteReasons();
   MediaTrackSettings getSettings();
   Promise&lt;undefined&gt; applyConstraints(optional MediaTrackConstraints constraints = {});
 };</pre>
@@ -1114,6 +1121,26 @@ <h2>Methods</h2>
                 <p>See <a href="#constrainable-interface">ConstrainablePattern
                 Interface</a> for the definition of this method.</p>
               </dd>
+              <dt><dfn>getMuteReasons</dfn></dt>
+              <dd>
+                <p>When a {{MediaStreamTrack}} object's {{MediaStreamTrack.getMuteReasons()}} method is invoked,
+                  the [=User Agent=] MUST run following steps:</p>
+                  <ol class="algorithm">
+                    <li>
+                      <p>Let <var>track</var> be the current {{MediaStreamTrack}} object.</p>
+                    </li>
+                    <li>
+                      <p>If <var>track</var>'s {{MediaStreamTrack/[[ReadyState]]}}
+                        is {{MediaStreamTrackState/"ended"}}, return an empty sequence.
+                      </p>
+                    </li>
+                    <li>
+                      <p>
+                        Return <var>track</var>.{{MediaStreamTrack/[[MuteReasons]]}}.
+                      </p>
+                    </li>
+                  </ol>  
+              </dd>
               <dt><dfn>getSettings</dfn></dt>
               <dd>
                 <p>When a {{MediaStreamTrack}} object's {{MediaStreamTrack.getSettings()}} method is invoked,
@@ -1588,6 +1615,38 @@ <h2>Dictionary {{MediaTrackConstraintSet}}
           </section>
         </div>
       </section>
+      <section id="mute-reason">
+        <h2><dfn>MuteReason</dfn></h2>
+        <p>
+          {{MuteReason}} represents information about why a {{MediaStreamTrack}}
+          is [=muted=]. Multiple reasons might apply concurrently. The information
+          exposed to applications might depend on certain conditions.
+        </p>
+        <div>
+          <pre class="idl">
+            [Exposed=Window]
+            interface MuteReason {
+              readonly attribute boolean explicitUpstream;
+            };
+          </pre>
+          <section>
+            <h2>{{MuteReason}} Members</h2>
+            <dl data-link-for="MuteReason" data-dfn-for="MuteReason" class="attributes">
+              <dt><dfn>explicitUpstream</dfn> of type {{boolean}}</dt>
+              <dd>
+                <p>
+                  <code>true</code> if the reason is an explicit decision to mute by an upstream
+                  entity such as the user agent, operating system or hardware.
+                </p>
+                <p>
+                  <code>false</code> if the reason is anything else, such as an error
+                  or a temporary absence of media for an unspecified reason.
+                </p>
+              </dd>
+            </dl>
+          </section>
+        </div>
+      </section>
       <section id="media-track-settings">
         <h2><dfn>MediaTrackSettings</dfn></h2>
         <p>{{MediaTrackSettings}} represents the

From 88ab7d04ecb0e3a314c61f1cee2666f2ed697cff Mon Sep 17 00:00:00 2001
From: Elad Alon <eladalon@google.com>
Date: Fri, 24 Nov 2023 14:15:13 +0100
Subject: [PATCH 2/2] Add note about source

---
 getusermedia.html | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/getusermedia.html b/getusermedia.html
index 0a871199..45b04f86 100644
--- a/getusermedia.html
+++ b/getusermedia.html
@@ -1640,12 +1640,20 @@ <h2>{{MuteReason}} Members</h2>
                 </p>
                 <p>
                   <code>false</code> if the reason is anything else, such as an error
-                  or a temporary absence of media for an unspecified reason.
+                  or a temporary absence of media for any reason.
                 </p>
               </dd>
             </dl>
           </section>
         </div>
+        <div class="note">
+          <p>
+            What additional information can be exposed, and under which conditions,
+            is actively debated. One proposal is to expose the MuteSource, with potential
+            values such as <code>"user-agent"</code>, <code>"operating-system"</code>,
+            <code>"hardware"</code> and <code>"unspecified"</code>.
+          </p>
+        </div>
       </section>
       <section id="media-track-settings">
         <h2><dfn>MediaTrackSettings</dfn></h2>