autoplay
Permissions-Policy Media

개요

autoplay 지시어는 <video>·<audio> 요소가 사용자 제스처 없이 자동 재생되거나 HTMLMediaElement.play()가 자동으로 성공할 수 있는지를 제어합니다. 기본 허용 목록은 self로, 같은 오리진 문서는 브라우저의 자동재생 정책 범위 안에서 재생을 시도할 수 있습니다.

자세히

`autoplay=*`는 모든 프레임에 허용, `autoplay=(self)`는 자기 오리진만, `autoplay=()`는 자동재생을 완전히 금지합니다. 광고·임베드 위젯 같은 교차 오리진 iframe이 자동재생하려면 부모가 `<iframe allow="autoplay">`로 위임해야 합니다. 위임이 없으면 프레임 안의 미디어는 음소거 상태에서도 자동재생이 막힐 수 있습니다.

정책이 자동재생을 거부하면 muted 속성 없이 호출한 play()가 반환하는 Promise는 NotAllowedError로 reject됩니다. 이는 브라우저 자체의 자동재생 정책(사용자 상호작용·미디어 인게이지먼트 지수)과 별개로 겹겹이 작용하므로, 정책이 허용해도 브라우저 휴리스틱 때문에 여전히 막힐 수 있습니다. 구형 Feature-Policy의 autoplay를 대체합니다.

문법

Permissions-Policy: autoplay=(self "https://cdn.example.com")

실무 참고

관련 지시어