Desktop capture monitor and desktop audio on Windows

[redgecombe]

This is API plumbing for the internal interfaces chromium uses to enumerate desktop capture streams and for getting their thumbnails. It allows for apps to implement their own desktop capture picker window in HTML/Javascript.

Here is a sample app that uses the API:
https://gist.github.com/redgecombe/835fe42b8308a0afaecc

gui.Screen.Init();
gui.Screen.DesktopCaptureMonitor.start(should_include_screens, should_include_monitors); //The screen capture API will monitor the system and trigger the below events.

To stop:
gui.Screen.DesktopCaptureMonitor.stop(); //The screen capture system will stop monitoring the system.

Events:
gui.Screen.DesktopCaptureMonitor.on("added", function (id, name, order, type, primary) {
//id is unique id that can be passed as chromeMediaSourceId
//name is the title of the window or screen
//order is the z-order of the windows, if screens are selected they will appear first
//type of the stream: "screen", "window", "other" or "unknown"
});
gui.Screen.DesktopCaptureMonitor.on("removed", function (id) {
//the id of the screen or monitor that is no longer capturable
});
gui.Screen.DesktopCaptureMonitor.on("orderchanged", function (id, new_order, old_order) {
//id is the screen or window that has changed z-order
//new_order is the new z-order
//old_order is the old z-order
});
gui.Screen.DesktopCaptureMonitor.on("namechanged", function (id, name) {
//id is the screen or window that has changed title
//name is the title
});
gui.Screen.DesktopCaptureMonitor.on("thumbnailchanged", function (id, thumbnail) {
//id is the screen or window that has an updated thumbnail
//thumbnail is the base64 encoded png of the thumbnail
});

[metal3d]

Maybe you can try on a Linux box ? because capturing dekstop on linux + audio doesn't work. You may have found a common problem.

[redgecombe]

This screen selection should work on Linux, but not the audio capture. I think Linux desktop audio is not supported in chromium yet: https://code.google.com/p/chromium/issues/detail?id=223639#c29

[rogerwang]

Thanks. This will be released with 0.12.3. And please add another PR to add yourself to AUTHORS.

[rogerwang]

@redgecombe could you please add the documentation to https://github.com/nwjs/nw.js/wiki/Screen ?

Then I'll announce v0.12.3 with this feature.

[redgecombe]

@rogerwang Added the documentation