Description
こんにちは TAG-さん!
I'm requesting a TAG review of windowAudio option for getDisplayMedia().
The windowAudio option extends the getDisplayMedia() API, allowing Web applications to provide a hint to the user agent regarding the preferred audio source. When getDisplayMedia() is called, the user agent allows the user to choose a tab, window or screen - and optionally a corresponding audio source.
- For tabs the corresponding audio source is that tab’s audio.
- For screens the corresponding audio source is system audio.
This new option affects the audio source associated with windows. In that case, the hint allows the Web application to indicate whether the UA should offer as the corresponding audio source the window’s audio, the system’s audio, or no audio at all. (The rationale for this is elaborated in the explainer, which is linked below.)
- Explainer: https://github.com/drkron/explainers/blob/main/windowAudio_Explainer.md
- Specification: https://w3c.github.io/mediacapture-screen-share/#dom-displaymediastreamoptions-windowaudio
- WPT Tests: WPT tests are not feasible because (i) this option is but a hint which can be spec-compliantly ignored by the user agent and (ii) the hint may affect the UA’s own UX, e.g. by affecting which of several possible audio sources is most prominently presented to the user.
- User research: N/A
- Security and Privacy self-review: https://github.com/drkron/documents/blob/main/sp-questionnaire-window-audio.md
- GitHub repo: https://github.com/w3c/mediacapture-screen-share
- Primary contacts:
- This work is being funded by: Google
- Primary standards group developing this feature:
- WebRTC WG
- Incubation and standards groups that have discussed the design:
- WebRTC WG
- Multi-stakeholder support:
- The feature has consensus in the WebRTC WG with positive feedback from all major browsers. It was discussed in the WebRTC WG meeting on May 20, 2025 and later merged to the specification.
- Major unresolved issues with or opposition to this specification: None.
- Status/issue trackers for implementations:
- Chrome Status: https://chromestatus.com/feature/5072779506089984
Further details:
- I have reviewed the TAG's Web Platform Design Principles
- Relevant time constraints or deadlines: None at this time.
You should also know that...
We believe this fills a crucial gap in the existing API by offering a hint for window-specific audio behavior, mirroring the existing SystemAudioPreferenceEnum for monitor captures.