개요

picture-in-picture 지시어는 HTMLVideoElement.requestPictureInPicture()로 동영상을 화면 위에 떠 있는 작은 창으로 분리할 수 있는지를 제어합니다. 다른 대다수 지시어와 달리 기본 허용 목록이 *(모든 오리진)이라, 명시하지 않으면 어디서나 허용됩니다.

자세히

`picture-in-picture=*`는 모든 오리진(기본값), `picture-in-picture=(self)`는 자기 오리진, `picture-in-picture=()`는 전면 차단, `picture-in-picture=(self "https://video.example.com")`는 지정 오리진에 위임합니다. 기본이 *이므로 PiP를 막고 싶다면 명시적으로 self 또는 ()로 좁혀야 합니다. iframe 세밀 제어에는 `allow="picture-in-picture"`를 씁니다.

정책이 거부하면 requestPictureInPicture()가 반환하는 Promise는 NotAllowedError로 reject됩니다. requestPictureInPicture()는 보통 사용자 제스처 안에서 호출되어야 하며, disablePictureInPicture 속성으로 특정 <video>에서 개별 차단도 가능합니다. 구형 Feature-Policy의 picture-in-picture를 대체합니다.

문법

Permissions-Policy: picture-in-picture=*

실무 참고

• 기본 허용 목록이 *이므로, PiP를 제한하려면 반드시 명시적으로 picture-in-picture=(self) 또는 =()로 지정하세요.
• 특정 동영상만 막으려면 <video disablepictureinpicture>를 사용할 수 있습니다.

관련 지시어