[mediacapture-screen-share] PIP window Excluded while getDisplayMedia (#330)

fideltian has just created a new issue for https://github.com/w3c/mediacapture-screen-share:

== PIP window Excluded while getDisplayMedia ==
When using web browsers to capture screen sharing streams through GetDisplayMedia, we're looking to implement an option that would exclude Picture-in-Picture windows from the shared media content.

I'd like to share some relevant use cases:

1) Certain applications need clip recording functionality (video, screen share, or combined) for lectures or promotional content. With PIP enabled, users can share additional materials while maintaining visibility of their own face. In this scenario, users want the entire capture to include the PIP window. However, when screen share and PIP video have different encoding fps/bitrate settings, the PIP video might need to be excluded for some special purposes.
2) For remote assistance scenarios, customers may want to record either the complete desktop with PIP or the full desktop without PIP.
Since customer requirements vary significantly, I believe having configurable exclusion control would be extremely beneficial.

3) We do have a customer would like us to prevent the option to do the whole screen share(options for control the screen sharing sources), due to some policy of themselves. this one seems to be resolved by monitorTypeSurfaces: "exclude".  

A proposal is similar, with adding a parameters  to exclude or include the PiPWindow. where the parameter only be effective while PiP window exists.


const stream = await navigator.mediaDevices.getDisplayMedia({
  monitorTypeSurfaces: "exclude|include",
  PiPWindow: "exclude|include"
});

Please view or discuss this issue at https://github.com/w3c/mediacapture-screen-share/issues/330 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Thursday, 16 April 2026 06:25:56 UTC