diff --git a/getusermedia.html b/getusermedia.html index f15d59fc..f5b8242b 100644 --- a/getusermedia.html +++ b/getusermedia.html @@ -2655,6 +2655,17 @@

MediaDevices Interface Extensions

If requestedMediaTypes is the empty set, return a promise rejected with a TypeError.

+
  • +

    If the current [[!HTML51]] + browsing context is a + nested browsing context which is not allowed to use user + media, return a promise rejected with a + DOMException object whose + name attribute has the value + SecurityError.

    +
  • Let p be a new promise.

  • @@ -2876,6 +2887,36 @@

    NavigatorUserMediaErrorCallback

    object or an OverconstrainedError object. +
    +

    User Media in an IFrame

    +

    There are some special circumstances when an [[!HTML51]] + + iframe wants to use user media. The iframe needs explicit + permission from the embedding page and it needs to identify itself in the + security prompt presented to the user. This section, together with the + getUserMedia() algorithm, specifies that + behavior.

    +

    The HTMLIFrameElement is extended with an allowusermedia content + attribute. allowusermedia is a [[!HTML51]] + boolean attribute. When specified, it indicates that scripts + in the iframe element's browsing context are allowed to use user + media (if it's not blocked for other reasons, e.g. there is another + ancestor iframe without this attribute set).

    +

    The iframe DOM interface is extended as described by the partial + interface below.

    +
    +
    attribute boolean allowUserMedia
    +
    +

    The allowUserMedia IDL attribute MUST [[!HTML51]] + reflect the allowusermedia content + attribute.

    +
    +
    +

    Implementation Suggestions