[w3ctag/design-reviews] windowAudio for getDisplayMedia (Issue #1110)

drkron created an issue (w3ctag/design-reviews#1110)

こんにちは 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:
     - Johannes Kron (@drkron), Google
     - Olga Sharanova (@o1ka), Google
 - 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](https://www.w3.org/2011/04/webrtc/wiki/May_20_2025) and later [merged](https://github.com/w3c/mediacapture-screen-share/pull/323) 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:

 - [x] I have reviewed the TAG's [Web Platform Design Principles](https://www.w3.org/TR/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.


-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3ctag/design-reviews/issues/1110
You are receiving this because you are subscribed to this thread.

Message ID: <w3ctag/design-reviews/issues/1110@github.com>