desktopCapturer

desktopCapturer 模块可用来获取可用资源，这个资源可通过 getUserMedia 捕获得到.

  1. // 在渲染进程中.
  2. var desktopCapturer = require('electron').desktopCapturer;
  4. desktopCapturer.getSources({types: ['window', 'screen']}, function(error, sources) {
  5.   if (error) throw error;
  6.   for (var i = 0; i < sources.length; ++i) {
  7.     if (sources[i].name == "Electron") {
  8.       navigator.webkitGetUserMedia({
  9.         audio: false,
  10.         video: {
  11.           mandatory: {
  12.             chromeMediaSource: 'desktop',
  13.             chromeMediaSourceId: sources[i].id,
  14.             minWidth: 1280,
  15.             maxWidth: 1280,
  16.             minHeight: 720,
  17.             maxHeight: 720
  18.           }
  19.         }
  20.       }, gotStream, getUserMediaError);
  21.       return;
  22.     }
  23.   }
  24. });
  26. function gotStream(stream) {
  27.   document.querySelector('video').src = URL.createObjectURL(stream);
  28. }
  30. function getUserMediaError(e) {
  31.   console.log('getUserMediaError');
  32. }

当调用 navigator.webkitGetUserMedia 时创建一个约束对象，如果使用 desktopCapturer 的资源，必须设置 chromeMediaSource 为 "desktop" ，并且 audio 为 false.

如果你想捕获整个桌面的 audio 和 video，你可以设置 chromeMediaSource 为 "screen" ，和 audio 为 true.当使用这个方法的时候，不可以指定一个 chromeMediaSourceId.

方法

desktopCapturer 模块有如下方法:

desktopCapturer.getSources(options, callback)

  • options Object
    • types Array - 一个 String 数组，列出了可以捕获的桌面资源类型, 可用类型为 screen 和 window.
    • thumbnailSize Object (可选) - 建议缩略可被缩放的 size, 默认为 {width: 150, height: 150}.
  • callback Function
    发起一个请求，获取所有桌面资源，当请求完成的时候使用 callback(error, sources) 调用 callback .

sources 是一个 Source 对象数组, 每个 Source 表示了一个捕获的屏幕或单独窗口，并且有如下属性 :

  • id String - 在 navigator.webkitGetUserMedia 中使用的捕获窗口或屏幕的 id . 格式为 window:XX 祸screen:XX，XX 是一个随机数.
  • name String - 捕获窗口或屏幕的描述名 . 如果资源为屏幕，名字为 Entire Screen 或 Screen <index>; 如果资源为窗口, 名字为窗口的标题.
  • thumbnail NativeImage - 缩略图.
    注意: 不能保证 source.thumbnail 的 size 和 options 中的 thumnbailSize 一直一致. 它也取决于屏幕或窗口的缩放比例.