diff --git a/index.html b/index.html index ce5cc44..b30ead1 100644 --- a/index.html +++ b/index.html @@ -152,7 +152,7 @@

partial interface MediaDevices {
-  Promise<MediaStream> getDisplayMedia(optional DisplayMediaStreamConstraints constraints = {});
+  Promise<MediaStream> getDisplayMedia(optional DisplayMediaStreamOptions options = {});
 };
@@ -162,8 +162,9 @@

Prompts the user for permission to live-capture their display.

The user agent MUST let the end-user choose which [=display surface=] to share - out of all available choices every time, and MUST NOT use constraints - to limit that choice. + out of all available choices every time, and MUST NOT use + any {{MediaTrackConstraints}} in options.video + or options.audio to limit that choice.

The user agent MAY use the presence of the {{displaySurface}} constraint and its value to @@ -173,8 +174,9 @@

as this poses risks to user privacy.

-

- Other than the {{displaySurface}} constraint, constraints MUST be applied +

+ Any {{MediaTrackConstraints}} in options.video + or options.audio MUST be applied to the media chosen by the user only after the user has made their selection.

@@ -207,9 +209,14 @@

attribute has the value {{InvalidStateError}}.

  • -

    Let constraints be the method's first +

    Let options be the method's first argument.

  • +
  • +

    Let constraints be + [options.audio, + options.video].

    +
  • If constraints.video is false, return a promise [=reject|rejected=] with a newly @@ -838,14 +845,14 @@

    SurfaceSwitchingPreferenceEnum

    -

    DisplayMediaStreamConstraints

    -

    The DisplayMediaStreamConstraints dictionary is used to +

    DisplayMediaStreamOptions

    +

    The DisplayMediaStreamOptions dictionary is used to instruct the user agent what sort of {{MediaStreamTrack}}s may be included in the {{MediaStream}} returned by {{MediaDevices/getDisplayMedia}}.

    -dictionary DisplayMediaStreamConstraints {
    +dictionary DisplayMediaStreamOptions {
       (boolean or MediaTrackConstraints) video = true;
       (boolean or MediaTrackConstraints) audio = false;
       SelfCapturePreferenceEnum selfBrowserSurface;
    @@ -853,10 +860,10 @@ 

    DisplayMediaStreamConstraints

    SurfaceSwitchingPreferenceEnum surfaceSwitching; };
    -

    Dictionary DisplayMediaStreamConstraints +

    Dictionary DisplayMediaStreamOptions Members

    -
    +
    video of type (boolean or {{MediaTrackConstraints}}), defaulting to true