v141 · miscellaneous

Support restrictOwnAudio

restrictOwnAudio is a captured display surfaces constrainable property. This constrainable property changes the behavior of system audio in a captured display surface. The restrictOwnAudio constraint will only have an effect if the captured display surface inherently includes system audio; otherwise, it will have no impact.

concepts

  1. restrictOwnAudio

    getDisplayMedia learns restrictOwnAudio — the captured stream omits the page's own audio, killing the classic feedback loop when sharing a tab during a video call.

  2. Embedded Video Loop

    Tutorial-recording scenario: page embeds a clip, default capture creates feedback. restrictOwnAudio: true keeps system audio while dropping this tab.

  3. Music App Screencast

    The inverse case — music apps that ARE the audio source. Shows the false-direction call and the getSettings() verification pattern.

  4. Audio Routing Demo

    Two capture buttons side by side — one with restrictOwnAudio: true, one without. Both connect to a Web Audio oscillator playing in the page so you can hear the feedback difference. A live frequency analyser visualises each captured track; getSettings() read-back confirms the applied constraint.

why it shipped

The restrictOwnAudio constraint allows for cleaner screen recordings for some use cases. Without it, if the capturing web page itself is playing audio (e.g. a video embedded on the on the recording page), that audio would be included in the capture. This could lead to an undesirable echo or interfere with the intended audio sources from other tabs or applications.

references