diff --git a/explainer.md b/explainer.md index 697d165..c34e56f 100644 --- a/explainer.md +++ b/explainer.md @@ -33,7 +33,6 @@ Many users want to continue consuming media while they interact with other conte ### For future considerations or candidates for first API * The API will take a hint for the preferred window size and position which could be ignored by the user agent. -* The API may be extended to allow an arbitrary element of the DOM to enter Picture-in-Picture. * The API may be extended to allow custom actions in the window UI. ## Proposed API diff --git a/index.bs b/index.bs index 8a40305..b5c2c09 100644 --- a/index.bs +++ b/index.bs @@ -12,7 +12,7 @@ Repository: w3c/picture-in-picture !Web Platform Tests: permissions-policy/
picture-in-picture/ Editor: François Beaufort, w3cid 81174, Google LLC https://www.google.com, fbeaufort@google.com Former Editor: Mounir Lamouri, w3cid 45389, Google LLC https://www.google.com, mlamouri@google.com -Abstract: This specification intends to provide APIs to allow websites to +Abstract: This specification provides APIs to allow websites to Abstract: create a floating video window always on top of other windows so that Abstract: users may continue consuming media while they interact with other Abstract: content sites, or applications on their device. @@ -56,8 +56,8 @@ window stays visible even when the user agent is not visible. Picture-in-Picture is a common platform-level feature among desktop and mobile OSs. -This specification aims to allow websites to initiate and control this behavior -by exposing the following sets of properties to the API: +This specification extends {{HTMLVideoElement}} allowing websites +to initiate and control this behavior by exposing the following sets of properties: * Notify the website when it enters and leaves Picture-in-Picture mode. * Allow the website to trigger Picture-in-Picture mode via a user gesture on a @@ -67,10 +67,6 @@ by exposing the following sets of properties to the API: * Allow the website to exit Picture-in-Picture mode. * Allow the website to check if Picture-in-Picture mode can be triggered. -The proposed Picture-in-Picture API is very similar to [[Fullscreen]] as they -have similar properties. The API only applies to -{{HTMLVideoElement}} at the moment but is meant to be -extensible. # Examples # {#examples} @@ -469,9 +465,10 @@ apply to the shadow host chain. This section is non-normative. -The API applies only to {{HTMLVideoElement}} in order to start on a minimal -viable product that has limited security issues. Later versions of this -specification may allow PIP-ing arbitrary HTML content. +To limit potential abuse through spoofing, the API applies only to +{{HTMLVideoElement}}. User interaction with the Picture-in-Picture window +is intentionally limited so that the only effect is on the Picture-in-Picture +window itself or the media being played. ## Secure Context ## {#secure-context}