dynamicSourceOption

index.html

@@ -796,6 +796,47 @@ <h2><dfn>SystemAudioPreferenceEnum</dfn></h2>
             </tbody>
           </table>
         </section>
+        <section>
+          <h2><dfn>DynamicSourceOptionPreferenceEnum</dfn></h2>
+          <p>
+            Describes whether an application invoking {{MediaDevices/getDisplayMedia()}}
+            would like the user agent to offer the user the option to dynamically change
+            the source [=display surface=] during the capture.
+          </p>
+          <pre class="idl">
+            enum DynamicSourceOptionPreferenceEnum {
+              "include",
+              "exclude"
+            };
+          </pre>
+          <table  data-dfn-for="DynamicSourceOptionPreferenceEnum" class="simple">
+            <tbody>
+              <tr>
+                <th colspan="2">
+                  Enumeration description
+                </th>
+              </tr>
+              <tr>
+                <td>
+                  <dfn id="idl-def-DynamicSourceOptionPreferenceEnum.include">include</dfn>
+                </td>
+                <td>
+                  The application prefers that option to dynamically change the source
+                  [=display surface=] during the capture be offered to the user.
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <dfn id="idl-def-DynamicSourceOptionPreferenceEnum.exclude">exclude</dfn>
+                </td>
+                <td>
+                  The application prefers that option to dynamically change the source
+                  [=display surface=] during the capture NOT be offered to the user.
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </section>
         <section>
           <h2>DisplayMediaStreamConstraints</h2>
           <p>The <dfn>DisplayMediaStreamConstraints</dfn> dictionary is used to
@@ -809,6 +850,7 @@ <h2>DisplayMediaStreamConstraints</h2>
   (boolean or MediaTrackConstraints) audio = false;
   SelfCapturePreferenceEnum selfBrowserSurface;
   SystemAudioPreferenceEnum systemAudio;
+  DynamicSourceOptionPreferenceEnum dynamicSourceOption;
 };</pre>
             <section>
               <h2>Dictionary <a class="idlType">DisplayMediaStreamConstraints</a>
@@ -855,6 +897,14 @@ <h2>Dictionary <a class="idlType">DisplayMediaStreamConstraints</a>
                   If present, signals whether the application would like system audio
                   to be included among the possible audio sources offered to the user.
                 </dd>
+                <dt>
+                  <dfn><code>dynamicSourceOption</code></dfn> of type {{DynamicSourceOptionPreferenceEnum}}
+                </dt>
+                <dd>
+                  If present, signals whether the application would like the
+                  user agent to offer the user the option to dynamically change
+                  the captured [=display surface=].
+                </dd>
               </dl>
             </section>
           </div>