The HTTP Permissions-Policy header speaker-selection directive controls whether the current document is allowed to enumerate and select audio output devices (speakers, headphones, and so on).
Specifically, where a defined policy blocks use of this feature:
- MediaDevices.enumerateDevices() won't return devices of type audio output.
- MediaDevices.selectAudioOutput() won't display the popup for selecting an audio output, and the returned Promise will reject with a DOMException of type
NotAllowedError. - HTMLMediaElement.setSinkId() and AudioContext.setSinkId() will throw a
NotAllowedErrorif called for an audio output.
Syntax
Permissions-Policy: speaker-selection=<allowlist>;
<allowlist>- : A list of origins for which permission is granted to use the feature. See
Permissions-Policy> Syntax for more details.
- : A list of origins for which permission is granted to use the feature. See
Default policy
The default allowlist for speaker-selection is self.
Specifications
Browser compatibility
See also
- Permissions-Policy header
- Permissions Policy
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
