Repository navigation
Detect when minimizing a window pauses capture (was: Capability polling - capture-while-minimized) #257
Description
Recall what the spec says about minimized surfaces:
A display surface that is being shared may temporarily or permanently become inaccessible to the application because of actions taken by the operating system or user agent. What makes a display surface considered inaccesible is outside the scope of this specification, but examples MAY include a monitor disconnecting, window or browser closing or becoming minimized, or due to an incoming call on a phone.
So minimizing a window might pause the capture.
Suppose a Web developer wants to warn users if minimizing windows would stop the capture; we have an example of such a developer here:
We need to give the user a hint that minimizing the window will cause the screen to not capture data
Currently, there's no way for this developer to know if the warning should be issued. It would be nice if developers could query that. Ideally before getDisplayMedia() is ever called, but possibly also after, via a MediaStreamTrackCapability.
Activity
youennf commentedon Jan 13, 2023
The current wording is unclear, is there a chance we can standardize more of the behavior in this area?
How about the following rules:
If we standardize more of the behavior, the developer will know which warnings to provide without querying a new capability or without doing UA string checks.
eladalon1983 commentedon Jan 13, 2023
Makes sense to me.
I am not sure that's desirable. Especially on Windows, I could see a user tapping the shared window's taskbar entry to just minimize a window and get it out of the way. It would not indicate a user's desire to stop the capture.
The OS-level APIs for capture might differ in whether they allow a minimized window to be captured.
jan-ivar commentedon Feb 15, 2024
This makes sense to me as well.
I agree. But it sounds like we agree that if minimizing windows would stop the capture, then the UA MUST fire mute/unmute while minimized.
Wouldn't this solve the OP use case?
[-]Capability polling - capture-while-minimized[/-][+]Detect when minimizing a window pauses capture (was: Capability polling - capture-while-minimized)[/+]jan-ivar commentedon Feb 15, 2024
Hmm the existing wording in https://w3c.github.io/mediacapture-screen-share/#hidden-display-surfaces seems to cover this fairly well. @youennf can you elaborate on what is not clear there?
youennf commentedon Feb 22, 2024
I was probably looking only at the paragraphe above.
The paragraphs in the spec after the quoted one above are indeed mentioning when to fire mute/unmute/ended events.
eladalon1983 commentedon May 21, 2024
It would almost solve the problem. Missing functionality includes:
MuteReasons...