MediaTrackSettings: restrictOwnAudio property
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The MediaTrackSettings dictionary's restrictOwnAudio property controls whether system audio originating from the capturing tab is filtered out of screen capture, allowing for cleaner screen recordings in some cases.
For example, if the capturing web page itself is playing embedded audio or video, that audio would be included in the capture. Since this could lead to an undesirable echo or interfere with the intended audio sources from other tabs or applications, removing it from the capture is desirable.
Value
A boolean value, where true enables the capturing tab's system audio restriction and false disables it.
If the value is true, the user agent will attempt to remove any audio originating from the captured audio produced by the tab that called MediaDevices.getDisplayMedia() to initiate screen capture. If removal of audio via processing fails, the user agent may exclude all audio originating from the capturing tab.
Note: If the captured display surface doesn't include system audio, this setting will have no effect.
Examples
The following function sets up a constraints object that specifies the options for a call to getDisplayMedia().
It adds the restrictOwnAudio constraint (requesting that system audio originating from the capturing tab be filtered out of the screen capture) only if it is known to be supported by the browser.
Capture then starts by calling getDisplayMedia() and attaching the returned stream to the <video> element referenced by the variable videoElem.
async function capture() {
const supportedConstraints = navigator.mediaDevices.getSupportedConstraints();
const displayMediaOptions = {
audio: {},
};
if (supportedConstraints.restrictOwnAudio) {
displayMediaOptions.audio.restrictOwnAudio = true;
}
try {
videoElem.srcObject =
await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
} catch (err) {
/* handle the error */
}
}
Specifications
| Specification |
|---|
| Screen Capture # dom-mediatrackconstraintset-restrictownaudio |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
restrictOwnAudio constraint
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.