@flashphoner/websdk 2.0.240 → 2.0.242

package/flashphoner-webrtc-only.js

@@ -8339,7 +8339,7 @@ var createSession = function createSession(options) {
    * @param {string=} options.stripCodecs Comma separated strings of codecs which should be stripped from WebRTC SDP (ex. "SILK,G722")
    * @param {Array<string>=} options.sipSDP Array of custom SDP params (ex. bandwidth (b=))
    * @param {Array<string>=} options.sipHeaders Array of custom SIP headers
-   * @param {string=} options.videoContentHint Video content hint for browser ('detail' by default to maintain resolution), {@link Flashphoner.constants.CONTENT_HINT_TYPE}
+   * @param {string=} options.videoContentHint Video content hint for browser ('motion' by default to maintain bitrate and fps), {@link Flashphoner.constants.CONTENT_HINT_TYPE}
    * @param {Boolean=} options.useControls Use a standard HTML5 video controls (play, pause, fullscreen). May be a workaround for fullscreen mode to work in Safari 16
    * @param {Object=} options.logger Call logger options
    * @param {sdpHook} sdpHook The callback that handles sdp from the server
@@ -9136,7 +9136,7 @@ var createSession = function createSession(options) {
    * @param {Boolean=} options.cvoExtension Enable rtp video orientation extension
    * @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 {string=} options.videoContentHint Video content hint for browser ('motion' by default to maintain bitrate and fps), {@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 {Boolean=} options.useControls Use a standard HTML5 video controls (play, pause, fullscreen). May be a workaround for fullscreen mode to work in Safari 16
    * @param {Object=} options.logger Stream logger options
@@ -9294,28 +9294,33 @@ var createSession = function createSession(options) {
         return;
       }
       var event = streamInfo.status;
-      if (event == INBOUND_VIDEO_RATE || event == OUTBOUND_VIDEO_RATE) {
+      if (event === INBOUND_VIDEO_RATE || event === OUTBOUND_VIDEO_RATE) {
         detectConnectionQuality(event, streamInfo);
         return;
       }
+      if (event === STREAM_EVENT) {
+        if (!streamInfo.mediaSessionId) streamInfo.mediaSessionId = id_;
+        streamEventRefreshHandlers[id_](streamInfo);
+        return;
+      }
 
-      //Depricated. WCS-3228: RESIZE, SNAPSHOT_COMPLETE and NOT_ENOUGH_BANDWIDTH moved to STREAM_EVENT
-      if (event == STREAM_STATUS.RESIZE) {
+      //Deprecated. WCS-3228: RESIZE, SNAPSHOT_COMPLETE and NOT_ENOUGH_BANDWIDTH moved to STREAM_EVENT
+      if (event === STREAM_STATUS.RESIZE) {
         resolution.width = streamInfo.streamerVideoWidth;
         resolution.height = streamInfo.streamerVideoHeight;
-      } else if (event == STREAM_STATUS.SNAPSHOT_COMPLETE) {} else if (event == STREAM_STATUS.NOT_ENOUGH_BANDWIDTH) {
+      } else if (event === STREAM_STATUS.SNAPSHOT_COMPLETE) {} else if (event === STREAM_STATUS.NOT_ENOUGH_BANDWIDTH) {
         var info = streamInfo.info.split("/");
         remoteBitrate = info[0];
         networkBandwidth = info[1];
       } else {
         status_ = event;
       }
-      audioState_ = streamInfo.audioState;
-      videoState_ = streamInfo.videoState;
+      if (streamInfo.audioState) audioState_ = streamInfo.audioState;
+      if (streamInfo.videoState) videoState_ = streamInfo.videoState;
       if (streamInfo.info) info_ = streamInfo.info;
 
       //release stream
-      if (event == STREAM_STATUS.FAILED || event == STREAM_STATUS.STOPPED || event == STREAM_STATUS.UNPUBLISHED) {
+      if (event === STREAM_STATUS.FAILED || event === STREAM_STATUS.STOPPED || event === STREAM_STATUS.UNPUBLISHED) {
         delete streams[id_];
         delete streamRefreshHandlers[id_];
         delete streamEventRefreshHandlers[id_];
@@ -9412,7 +9417,8 @@ var createSession = function createSession(options) {
         playoutDelay: playoutDelay,
         unmutePlayOnStart: unmutePlayOnStart,
         useControls: useControls,
-        logger: logger
+        logger: logger,
+        unmuteRequiredEvent: fireUnmuteEvent
       }, streamRefreshHandlers[id_]).then(function (newConnection) {
         mediaConnection = newConnection;
         try {
@@ -10087,6 +10093,16 @@ var createSession = function createSession(options) {
     var getLogger = function getLogger() {
       return streamLogger;
     };
+    var fireUnmuteEvent = function fireUnmuteEvent() {
+      if (isRemoteAudioMuted()) {
+        if (streamRefreshHandlers[id_] && typeof streamRefreshHandlers[id_] === 'function') {
+          streamRefreshHandlers[id_]({
+            status: STREAM_EVENT,
+            type: STREAM_EVENT_TYPE.UNMUTE_REQUIRED
+          });
+        }
+      }
+    };
     stream.play = play;
     stream.publish = publish;
     stream.stop = stop;
@@ -10930,11 +10946,14 @@ var createConnection = function createConnection(options) {
     var screenShare = false;
     var playoutDelay = options.playoutDelay;
     // Set video track contentHint to `detail` by default to workaround Chromium 91 bug #WCS-3257
-    var videoContentHint = options.videoContentHint ? options.videoContentHint : 'detail';
+    // Set video track contentHint to `motion` by default to keep bitrate and fps for better camera stream quality #WCS-4109
+    var videoContentHint = options.videoContentHint ? options.videoContentHint : 'motion';
     // Pass the option to unmute automatically (true by default) #WCS-2425
     var unmutePlayOnStart = options.unmutePlayOnStart !== undefined ? options.unmutePlayOnStart : true;
     // Use a standard HTML5 video controls if needed (to enable fullscreen in Safari 16 for example) #WCS-3606
     var useControls = options.useControls || false;
+    // Stream event handler to rise an event #WCS-4097
+    var unmuteRequiredEvent = options.unmuteRequiredEvent ? options.unmuteRequiredEvent : null;
     if (bidirectional) {
       localVideo = getCacheInstance(localDisplay);
       if (localVideo) {
@@ -11046,6 +11065,9 @@ var createConnection = function createConnection(options) {
               // Automatically unmute video if needed #WCS-2425
               if (unmutePlayOnStart) {
                 remoteVideo.muted = false;
+              } else {
+                // Fire UNMUTE_REQUIRED stream event #WCS-4097
+                fireUnmuteEvent();
               }
             })["catch"](function (e) {
               if (validBrowsers.includes(browserDetails.browser)) {
@@ -11054,6 +11076,8 @@ var createConnection = function createConnection(options) {
                 logger.info(LOG_PREFIX, "Autoplay detected! Trying to play a video with a muted sound...");
                 remoteVideo.muted = true;
                 remoteVideo.play();
+                // Fire UNMUTE_REQUIRED stream event #WCS-4097
+                fireUnmuteEvent();
               } else {
                 logger.error(LOG_PREFIX, e);
               }
@@ -11644,6 +11668,11 @@ var createConnection = function createConnection(options) {
         }
       });
     };
+    var fireUnmuteEvent = function fireUnmuteEvent() {
+      if (unmuteRequiredEvent && typeof unmuteRequiredEvent === 'function') {
+        unmuteRequiredEvent();
+      }
+    };
     var exports = {};
     exports.state = state;
     exports.createOffer = createOffer;