microphone
Permissions-Policy Media

개요

microphone 지시어는 navigator.mediaDevices.getUserMedia({ audio: true })로 마이크 오디오 트랙을 획득할 수 있는지를 제어합니다. 기본 허용 목록은 self로, 같은 오리진 문서만 기본 접근이 가능하고 교차 오리진 프레임은 위임이 필요합니다.

자세히

`microphone=*`는 모든 오리진, `microphone=(self)`는 자기 오리진, `microphone=()`는 전면 차단, `microphone=(self "https://meet.example.com")`는 자기 오리진과 지정 오리진에만 허용합니다. 화상·음성 위젯 iframe에 마이크를 위임하려면 부모 허용 목록에 그 오리진이 있고 `<iframe allow="microphone">`로 위임해야 하며, camera와 함께 `allow="camera; microphone"`로 흔히 지정합니다.

정책이 거부하면 오디오 getUserMedia Promise가 NotAllowedError로 reject되며, 사용자 권한 프롬프트조차 뜨지 않습니다. Permissions-Policy는 접근 가능 오리진을 정하는 앞단이고, 그 위에서 사용자 권한이 최종 결정합니다. 보안 컨텍스트(HTTPS)에서만 동작하며 구형 Feature-Policy의 microphone을 대체합니다.

문법

Permissions-Policy: microphone=(self "https://meet.example.com")

실무 참고

관련 지시어