feat(electron): basic Electron SS support

modules/RTC/RTCBrowserType.js

@@ -20,6 +20,8 @@ var RTCBrowserType = {
 
     RTC_BROWSER_NWJS: "rtc_browser.nwjs",
 
+    RTC_BROWSER_ELECTRON: "rtc_browser.electron",
+
     RTC_BROWSER_REACT_NATIVE: "rtc_browser.react-native",
 
     /**
@@ -90,6 +92,14 @@ var RTCBrowserType = {
         return currentBrowser === RTCBrowserType.RTC_BROWSER_NWJS;
     },
 
+    /**
+     * Checks if current environment is Electron.
+     * @returns {boolean}
+     */
+    isElectron: function () {
+        return currentBrowser === RTCBrowserType.RTC_BROWSER_ELECTRON;
+    },
+
     /**
      * Checks if current environment is React Native.
      * @returns {boolean}
@@ -237,6 +247,20 @@ function detectIE() {
     return version;
 }
 
+/**
+ * Detects Electron environment.
+ */
+function detectElectron (){
+    var userAgent = navigator.userAgent;
+    if (userAgent.match(/Electron/)) {
+        currentBrowser = RTCBrowserType.RTC_BROWSER_ELECTRON;
+        var version = userAgent.match(/Electron\/([\d.]+)/)[1];
+        logger.info("This appears to be Electron, ver: " + version);
+        return version;
+    }
+    return null;
+}
+
 function detectNWJS (){
     var userAgent = navigator.userAgent;
     if (userAgent.match(/JitsiMeetNW/)) {
@@ -280,6 +304,7 @@ function detectBrowser() {
     var version;
     var detectors = [
         detectReactNative,
+        detectElectron,
         detectNWJS,
         detectOpera,
         detectChrome,

modules/RTC/RTCUtils.js

@@ -788,6 +788,7 @@ var RTCUtils = {
             } else if (RTCBrowserType.isChrome() ||
                     RTCBrowserType.isOpera() ||
                     RTCBrowserType.isNWJS() ||
+                    RTCBrowserType.isElectron() ||
                     RTCBrowserType.isReactNative()) {
                 this.peerconnection = webkitRTCPeerConnection;
                 var getUserMedia = navigator.webkitGetUserMedia.bind(navigator);
@@ -1181,7 +1182,8 @@ var RTCUtils = {
                 RTCBrowserType.isFirefox() ||
                 RTCBrowserType.isOpera() ||
                 RTCBrowserType.isTemasysPluginUsed()||
-                RTCBrowserType.isNWJS();
+                RTCBrowserType.isNWJS() ||
+                RTCBrowserType.isElectron();
     },
     /**
      * A method to handle stopping of the stream.

modules/RTC/ScreenObtainer.js

@@ -113,6 +113,14 @@ var ScreenObtainer = {
                             onFailure(jitsiError);
                     });
             };
+        } else if(RTCBrowserType.isElectron()) {
+            obtainDesktopStream = (options, onSuccess, onFailure) =>
+                window.JitsiMeetElectron.obtainDesktopStream (
+                    streamId =>
+                        onGetStreamResponse({streamId}, onSuccess, onFailure),
+                    err => onFailure(new JitsiTrackError(
+                        JitsiTrackErrors.CHROME_EXTENSION_GENERIC_ERROR, err))
+                );
         } else if (RTCBrowserType.isTemasysPluginUsed()) {
             // XXX Don't require Temasys unless it's to be used because it
             // doesn't run on React Native, for example.
@@ -428,27 +436,7 @@ function doGetStreamFromExtension(options, streamCallback, failCallback) {
                 return;
             }
             logger.log("Response from extension: ", response);
-            if (response.streamId) {
-                GUM(
-                    ['desktop'],
-                    stream => streamCallback(stream),
-                    failCallback,
-                    { desktopStream: response.streamId });
-            } else {
-                // As noted in Chrome Desktop Capture API:
-                // If user didn't select any source (i.e. canceled the prompt)
-                // then the callback is called with an empty streamId.
-                if(response.streamId === "")
-                {
-                    failCallback(new JitsiTrackError(
-                        JitsiTrackErrors.CHROME_EXTENSION_USER_CANCELED));
-                    return;
-                }
-
-                failCallback(new JitsiTrackError(
-                    JitsiTrackErrors.CHROME_EXTENSION_GENERIC_ERROR,
-                    response.error));
-            }
+            onGetStreamResponse(response, streamCallback, failCallback);
         }
     );
 }
@@ -513,6 +501,39 @@ function waitForExtensionAfterInstall(options, waitInterval, retries) {
     });
 }
 
+/**
+ * Handles response from external application / extension and calls GUM to
+ * receive the desktop streams or reports error.
+ * @param {object} response
+ * @param {string} response.streamId - the streamId for the desktop stream
+ * @param {string} response.error - error to be reported.
+ * @param {Function} onSuccess - callback for success.
+ * @param {Function} onFailure - callback for failure.
+ */
+function onGetStreamResponse(response, onSuccess, onFailure) {
+    if (response.streamId) {
+        GUM(
+            ['desktop'],
+            stream => onSuccess(stream),
+            onFailure,
+            { desktopStream: response.streamId });
+    } else {
+        // As noted in Chrome Desktop Capture API:
+        // If user didn't select any source (i.e. canceled the prompt)
+        // then the callback is called with an empty streamId.
+        if(response.streamId === "")
+        {
+            onFailure(new JitsiTrackError(
+                JitsiTrackErrors.CHROME_EXTENSION_USER_CANCELED));
+            return;
+        }
+
+        onFailure(new JitsiTrackError(
+            JitsiTrackErrors.CHROME_EXTENSION_GENERIC_ERROR,
+            response.error));
+    }
+}
+
 /**
  * Starts the detection of an installed jidesha extension for firefox.
  * @param options supports "desktopSharingFirefoxDisabled",