From 295ba4902150dacbb0cf57c0b24d1f330ccbc3a4 Mon Sep 17 00:00:00 2001 From: Dan Burnett Date: Thu, 13 Oct 2016 07:29:32 -0400 Subject: [PATCH 1/3] add permissions display requirements and suggestions --- getusermedia.html | 77 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/getusermedia.html b/getusermedia.html index 33aaa4d5..ac4b2e66 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -5025,6 +5025,83 @@

Examples

+
+

User Experience Requirements

+

For each device for which there is a + [[\devicesAccessibleMap]][device]<\var> internal slot, + define <device>Accessible to be On whenever the + slot has a value of true and Off otherwise.

+

For each device for which there is a + [[\devicesLiveMap]][device]<\var> internal slot, + define <device>Live to be On whenever the + slot has a value of true and Off otherwise.

+

For each kind of device that getUserMedia() + exposes,

+ +

Define Accessible to be On + whenever <kind>Accessible is On for + any kind and Off otherwise.

+

Define Live to be On + whenever <kind>Live is On for + any kind and Off otherwise.

+

Then the following are requirements on the User Agent:

+
+

Privacy and Security Considerations

This section is non-normative; it specifies no new behavior, but instead From 4e4b25880f10c7fe9440cab78b5d8103fbb1f45a Mon Sep 17 00:00:00 2001 From: Dan Burnett Date: Thu, 13 Oct 2016 07:40:09 -0400 Subject: [PATCH 2/3] fix typo --- getusermedia.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getusermedia.html b/getusermedia.html index ac4b2e66..1f19d4dc 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -5028,11 +5028,11 @@

Examples

User Experience Requirements

For each device for which there is a - [[\devicesAccessibleMap]][device]<\var> internal slot, + [[\devicesAccessibleMap]][device] internal slot, define <device>Accessible to be On whenever the slot has a value of true and Off otherwise.

For each device for which there is a - [[\devicesLiveMap]][device]<\var> internal slot, + [[\devicesLiveMap]][device] internal slot, define <device>Live to be On whenever the slot has a value of true and Off otherwise.

For each kind of device that getUserMedia() From 79333a5885b0d2018ff1865c17375b499b19f29d Mon Sep 17 00:00:00 2001 From: Dan Burnett Date: Thu, 13 Oct 2016 07:42:53 -0400 Subject: [PATCH 3/3] more formatting --- getusermedia.html | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/getusermedia.html b/getusermedia.html index 1f19d4dc..d07382c2 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -5055,26 +5055,26 @@

User Experience Requirements

whenever <kind>Live is On for any kind and Off otherwise.

Then the following are requirements on the User Agent:

-
    -
  • The User Agent MUST indicate to the user when the value - of Accessible changes.
    • -
  • The User Agent MUST indicate to the user when the value - of Live changes.
    • -
  • If the User Agent provides any indication of Accessible or - Live to the user per kind, then for each such - value at a minimum it MUST indicate when the value - changes.
    • -
  • If the User Agent provides any indication of Accessible or - Live to the user per device, then for each such - value at a minimum it MUST indicate when the value - changes.
    • -
  • Any off-to-on transition MUST remain observable for a - sufficient time that a reasonably-observant user could become - aware of it.
    • -
  • Any of the above indications MAY be combined as long as - the combined indication cannot transition to off if any of its - component indications are still on.
    • - +
      +
    • The User Agent MUST indicate to the user when the value + of Accessible changes.
      • +
    • The User Agent MUST indicate to the user when the value + of Live changes.
      • +
    • If the User Agent provides any indication of Accessible or + Live to the user per kind, then for each such + value at a minimum it MUST indicate when the value + changes.
      • +
    • If the User Agent provides any indication of Accessible or + Live to the user per device, then for each such + value at a minimum it MUST indicate when the value + changes.
      • +
    • Any off-to-on transition MUST remain observable for a + sufficient time that a reasonably-observant user could become + aware of it.
      • +
    • Any of the above indications MAY be combined as long as + the combined indication cannot transition to off if any of its + component indications are still on.
      • +

    and the following are encouraged behaviors for the User Agent:

    • The User Agent is encouraged to provide ongoing indication