Permissions-Policy: speaker-selection
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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 returnedPromise
will reject with aDOMException
of typeNotAllowedError
.HTMLMediaElement.setSinkId()
andAudioContext.setSinkId()
will throw aNotAllowedError
if called for an audio output.
Syntax
http
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.
Default policy
The default allowlist for speaker-selection
is self
.
Specifications
Specification |
---|
Audio Output Devices API # permissions-policy-integration |
Browser compatibility
BCD tables only load in the browser