@flashphoner/websdk 2.0.208 → 2.0.212

package/flashphoner-temasys-flash-websocket-without-adapterjs.js

@@ -12656,6 +12656,9 @@ var getSession = function getSession(id) {
  * @param {Object=} options.sipOptions Sip configuration
  * @param {Object=} options.mediaOptions Media connection configuration
  * @param {Integer=} options.timeout Connection timeout in milliseconds
+ * @param {Integer=} options.pingInterval Server ping interval in milliseconds [0]
+ * @param {Integer=} options.receiveProbes A maximum subsequental pings received missing count [0]
+ * @param {Integer=} options.probesInterval Interval to check subsequental pings received [0]
  * @returns {Session} Created session
  * @throws {Error} Error if API is not initialized
  * @throws {TypeError} Error if options.urlServer is not specified
@@ -12682,6 +12685,8 @@ var createSession = function createSession(options) {
   var mediaOptions = options.mediaOptions;
   var keepAlive = options.keepAlive;
   var timeout = options.timeout;
+  var wsPingSender = new WSPingSender(options.pingInterval || 0);
+  var wsPingReceiver = new WSPingReceiver(options.receiveProbes || 0, options.probesInterval || 0);
   var connectionTimeout;
   var cConfig; //SIP config
 
@@ -12799,7 +12804,7 @@ var createSession = function createSession(options) {
         mediaProviders: Object.keys(MediaProvider),
         keepAlive: keepAlive,
         authToken: authToken,
-        clientVersion: "2.0.208",
+        clientVersion: "2.0.212",
         clientOSVersion: window.navigator.appVersion,
         clientBrowserVersion: window.navigator.userAgent,
         msePacketizationVersion: 2,
@@ -12812,7 +12817,11 @@ var createSession = function createSession(options) {
 
 
       send("connection", cConfig);
-      logger.setConnection(wsConnection);
+      logger.setConnection(wsConnection); // Send ping messages to server to check if connection is still alive #WCS-3410
+
+      wsPingSender.start(); // Check subsequintel pings received from server to check if connection is still alive #WCS-3410
+
+      wsPingReceiver.start();
     };
 
     wsConnection.onmessage = function (event) {
@@ -12828,6 +12837,7 @@ var createSession = function createSession(options) {
       switch (data.message) {
         case 'ping':
           send("pong", null);
+          wsPingReceiver.success();
           break;
 
         case 'getUserData':
@@ -12987,7 +12997,11 @@ var createSession = function createSession(options) {
     sessionStatus = newStatus;
 
     if (sessionStatus == SESSION_STATUS.DISCONNECTED || sessionStatus == SESSION_STATUS.FAILED) {
-      //remove streams
+      // Stop pinging server #WCS-3410
+      wsPingSender.stop(); // Stop checking pings received #WCS-3410
+
+      wsPingReceiver.stop(); //remove streams
+
       for (var prop in streamRefreshHandlers) {
         if (streamRefreshHandlers.hasOwnProperty(prop) && typeof streamRefreshHandlers[prop] === 'function') {
           streamRefreshHandlers[prop]({
@@ -13003,6 +13017,73 @@ var createSession = function createSession(options) {
     if (callbacks[sessionStatus]) {
       callbacks[sessionStatus](session, obj);
     }
+  } // Websocket periodic ping sender
+
+
+  function WSPingSender(interval) {
+    this.interval = interval || 0;
+    this.intervalId = null;
+
+    this.start = function () {
+      if (this.interval > 0) {
+        this.intervalId = setInterval(function () {
+          send("ping", null);
+        }, this.interval);
+      }
+    };
+
+    this.stop = function () {
+      if (this.intervalId) {
+        clearInterval(this.intervalId);
+      }
+    };
+
+    return this;
+  } // Websocket ping receive prober
+
+
+  function WSPingReceiver(receiveProbes, probesInterval) {
+    this.maxPings = receiveProbes || 0;
+    this.interval = probesInterval || 0;
+    this.intervalId = null;
+    this.pingsMissing = 0;
+
+    this.start = function () {
+      if (this.maxPings > 0 && this.interval > 0) {
+        var receiver = this;
+        this.intervalId = setInterval(function () {
+          receiver.checkPingsReceived();
+        }, this.interval);
+      }
+    };
+
+    this.stop = function () {
+      if (this.intervalId) {
+        clearInterval(this.intervalId);
+      }
+
+      this.pingsMissing = 0;
+    };
+
+    this.checkPingsReceived = function () {
+      this.pingsMissing++;
+
+      if (this.pingsMissing >= this.maxPings) {
+        this.failure();
+      }
+    };
+
+    this.success = function () {
+      this.pingsMissing = 0;
+    };
+
+    this.failure = function () {
+      logger.info(LOG_PREFIX, "Missing " + this.pingsMissing + " pings from server, connection seems to be down");
+      onSessionStatusChange(SESSION_STATUS.FAILED);
+      wsConnection.close();
+    };
+
+    return this;
   }
   /**
    * @callback sdpHook
@@ -13867,7 +13948,7 @@ var createSession = function createSession(options) {
    * @param {HTMLElement} options.display Div element stream should be displayed in
    * @param {Object=} options.custom User provided custom object that will be available in REST App code
    * @param {Integer} [options.flashBufferTime=0] Specifies how long to buffer messages before starting to display the stream (Flash-only)
-   * @param {String=} options.stripCodecs Comma separated string of codecs which should be stripped from WebRTC SDP (ex. "H264,PCMA,PCMU,G722")
+   * @param {string=} options.stripCodecs Comma separated string of codecs which should be stripped from WebRTC SDP (ex. "H264,PCMA,PCMU,G722")
    * @param {string=} options.rtmpUrl Rtmp url stream should be forwarded to
    * @param {Object=} options.mediaConnectionConstraints Stream specific constraints for underlying RTCPeerConnection
    * @param {Boolean=} options.flashShowFullScreenButton Show full screen button in flash
@@ -13876,6 +13957,7 @@ var createSession = function createSession(options) {
    * @param {Integer=} options.playoutDelay Time delay between network reception of media and playout
    * @param {string=} options.useCanvasMediaStream EXPERIMENTAL: when publish bind browser's media stream to the canvas. It can be useful for image filtering
    * @param {string=} options.videoContentHint Video content hint for browser ('detail' by default to maintain resolution), {@link Flashphoner.constants.CONTENT_HINT_TYPE}
+   * @param {Boolean=} options.unmutePlayOnStart Unmute playback on start. May be used after user gesture only, so set 'unmutePlayOnStart: false' for autoplay
    * @param {sdpHook} sdpHook The callback that handles sdp from the server
    * @returns {Stream} Stream
    * @throws {TypeError} Error if no options provided
@@ -13987,6 +14069,7 @@ var createSession = function createSession(options) {
     var playoutDelay = options.playoutDelay;
     var useCanvasMediaStream = options.useCanvasMediaStream;
     var videoContentHint = options.videoContentHint;
+    var unmutePlayOnStart = options.unmutePlayOnStart;
     var audioState_;
     var videoState_;
     var connectionQuality;
@@ -14163,7 +14246,8 @@ var createSession = function createSession(options) {
         connectionConstraints: mediaConnectionConstraints,
         audioOutputId: audioOutputId,
         remoteVideo: remoteVideo,
-        playoutDelay: playoutDelay
+        playoutDelay: playoutDelay,
+        unmutePlayOnStart: unmutePlayOnStart
       }, streamRefreshHandlers[id_]).then(function (newConnection) {
         mediaConnection = newConnection;
 

package/flashphoner-temasys-flash-websocket.js

@@ -19411,6 +19411,9 @@ var getSession = function getSession(id) {
  * @param {Object=} options.sipOptions Sip configuration
  * @param {Object=} options.mediaOptions Media connection configuration
  * @param {Integer=} options.timeout Connection timeout in milliseconds
+ * @param {Integer=} options.pingInterval Server ping interval in milliseconds [0]
+ * @param {Integer=} options.receiveProbes A maximum subsequental pings received missing count [0]
+ * @param {Integer=} options.probesInterval Interval to check subsequental pings received [0]
  * @returns {Session} Created session
  * @throws {Error} Error if API is not initialized
  * @throws {TypeError} Error if options.urlServer is not specified
@@ -19437,6 +19440,8 @@ var createSession = function createSession(options) {
   var mediaOptions = options.mediaOptions;
   var keepAlive = options.keepAlive;
   var timeout = options.timeout;
+  var wsPingSender = new WSPingSender(options.pingInterval || 0);
+  var wsPingReceiver = new WSPingReceiver(options.receiveProbes || 0, options.probesInterval || 0);
   var connectionTimeout;
   var cConfig; //SIP config
 
@@ -19554,7 +19559,7 @@ var createSession = function createSession(options) {
         mediaProviders: Object.keys(MediaProvider),
         keepAlive: keepAlive,
         authToken: authToken,
-        clientVersion: "2.0.208",
+        clientVersion: "2.0.212",
         clientOSVersion: window.navigator.appVersion,
         clientBrowserVersion: window.navigator.userAgent,
         msePacketizationVersion: 2,
@@ -19567,7 +19572,11 @@ var createSession = function createSession(options) {
 
 
       send("connection", cConfig);
-      logger.setConnection(wsConnection);
+      logger.setConnection(wsConnection); // Send ping messages to server to check if connection is still alive #WCS-3410
+
+      wsPingSender.start(); // Check subsequintel pings received from server to check if connection is still alive #WCS-3410
+
+      wsPingReceiver.start();
     };
 
     wsConnection.onmessage = function (event) {
@@ -19583,6 +19592,7 @@ var createSession = function createSession(options) {
       switch (data.message) {
         case 'ping':
           send("pong", null);
+          wsPingReceiver.success();
           break;
 
         case 'getUserData':
@@ -19742,7 +19752,11 @@ var createSession = function createSession(options) {
     sessionStatus = newStatus;
 
     if (sessionStatus == SESSION_STATUS.DISCONNECTED || sessionStatus == SESSION_STATUS.FAILED) {
-      //remove streams
+      // Stop pinging server #WCS-3410
+      wsPingSender.stop(); // Stop checking pings received #WCS-3410
+
+      wsPingReceiver.stop(); //remove streams
+
       for (var prop in streamRefreshHandlers) {
         if (streamRefreshHandlers.hasOwnProperty(prop) && typeof streamRefreshHandlers[prop] === 'function') {
           streamRefreshHandlers[prop]({
@@ -19758,6 +19772,73 @@ var createSession = function createSession(options) {
     if (callbacks[sessionStatus]) {
       callbacks[sessionStatus](session, obj);
     }
+  } // Websocket periodic ping sender
+
+
+  function WSPingSender(interval) {
+    this.interval = interval || 0;
+    this.intervalId = null;
+
+    this.start = function () {
+      if (this.interval > 0) {
+        this.intervalId = setInterval(function () {
+          send("ping", null);
+        }, this.interval);
+      }
+    };
+
+    this.stop = function () {
+      if (this.intervalId) {
+        clearInterval(this.intervalId);
+      }
+    };
+
+    return this;
+  } // Websocket ping receive prober
+
+
+  function WSPingReceiver(receiveProbes, probesInterval) {
+    this.maxPings = receiveProbes || 0;
+    this.interval = probesInterval || 0;
+    this.intervalId = null;
+    this.pingsMissing = 0;
+
+    this.start = function () {
+      if (this.maxPings > 0 && this.interval > 0) {
+        var receiver = this;
+        this.intervalId = setInterval(function () {
+          receiver.checkPingsReceived();
+        }, this.interval);
+      }
+    };
+
+    this.stop = function () {
+      if (this.intervalId) {
+        clearInterval(this.intervalId);
+      }
+
+      this.pingsMissing = 0;
+    };
+
+    this.checkPingsReceived = function () {
+      this.pingsMissing++;
+
+      if (this.pingsMissing >= this.maxPings) {
+        this.failure();
+      }
+    };
+
+    this.success = function () {
+      this.pingsMissing = 0;
+    };
+
+    this.failure = function () {
+      logger.info(LOG_PREFIX, "Missing " + this.pingsMissing + " pings from server, connection seems to be down");
+      onSessionStatusChange(SESSION_STATUS.FAILED);
+      wsConnection.close();
+    };
+
+    return this;
   }
   /**
    * @callback sdpHook
@@ -20622,7 +20703,7 @@ var createSession = function createSession(options) {
    * @param {HTMLElement} options.display Div element stream should be displayed in
    * @param {Object=} options.custom User provided custom object that will be available in REST App code
    * @param {Integer} [options.flashBufferTime=0] Specifies how long to buffer messages before starting to display the stream (Flash-only)
-   * @param {String=} options.stripCodecs Comma separated string of codecs which should be stripped from WebRTC SDP (ex. "H264,PCMA,PCMU,G722")
+   * @param {string=} options.stripCodecs Comma separated string of codecs which should be stripped from WebRTC SDP (ex. "H264,PCMA,PCMU,G722")
    * @param {string=} options.rtmpUrl Rtmp url stream should be forwarded to
    * @param {Object=} options.mediaConnectionConstraints Stream specific constraints for underlying RTCPeerConnection
    * @param {Boolean=} options.flashShowFullScreenButton Show full screen button in flash
@@ -20631,6 +20712,7 @@ var createSession = function createSession(options) {
    * @param {Integer=} options.playoutDelay Time delay between network reception of media and playout
    * @param {string=} options.useCanvasMediaStream EXPERIMENTAL: when publish bind browser's media stream to the canvas. It can be useful for image filtering
    * @param {string=} options.videoContentHint Video content hint for browser ('detail' by default to maintain resolution), {@link Flashphoner.constants.CONTENT_HINT_TYPE}
+   * @param {Boolean=} options.unmutePlayOnStart Unmute playback on start. May be used after user gesture only, so set 'unmutePlayOnStart: false' for autoplay
    * @param {sdpHook} sdpHook The callback that handles sdp from the server
    * @returns {Stream} Stream
    * @throws {TypeError} Error if no options provided
@@ -20742,6 +20824,7 @@ var createSession = function createSession(options) {
     var playoutDelay = options.playoutDelay;
     var useCanvasMediaStream = options.useCanvasMediaStream;
     var videoContentHint = options.videoContentHint;
+    var unmutePlayOnStart = options.unmutePlayOnStart;
     var audioState_;
     var videoState_;
     var connectionQuality;
@@ -20918,7 +21001,8 @@ var createSession = function createSession(options) {
         connectionConstraints: mediaConnectionConstraints,
         audioOutputId: audioOutputId,
         remoteVideo: remoteVideo,
-        playoutDelay: playoutDelay
+        playoutDelay: playoutDelay,
+        unmutePlayOnStart: unmutePlayOnStart
       }, streamRefreshHandlers[id_]).then(function (newConnection) {
         mediaConnection = newConnection;