← Back to release summary

windowAudio for getDisplayMedia()

Category
Miscellaneous
Type
New or changed feature
Status
Proposed (Chrome Proposed)
Intent stage
None

Summary

Extends DisplayMediaStreamOptions for getDisplayMedia() with a windowAudio option. This new option allows web applications to hint to the user agent whether the user should be offered the ability to share audio when a window is selected. windowAudio can be set to exclude, system, or window based on application preference. A web application that is configured for audio capture but wants to limit system audio capture when a window is selected should set windowAudio: "exclude".

Motivation

Improving audio capture control with getDisplayMedia(). This feature allows web applications to suggest preferred audio sources (system-wide, window-specific, or no audio) when a user selects a window for screen sharing. This helps web developers provide more intuitive and contextually relevant audio sharing options to users, reducing the need for users to manually adjust audio settings during screen capture.

Standards & signals

Explainers: https://github.com/drkron/explainers/blob/main/windowAudio_Explainer.md

View on chromestatus.com