@webex/calling 3.12.0-next.82 → 3.12.0-next.84

package/dist/CallingClient/calling/call.js

@@ -53,7 +53,7 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
   /**
    * @ignore
    */
-  function Call(activeUrl, webex, direction, deviceId, lineId, deleteCb, indicator, destination) {
+  function Call(activeUrl, webex, direction, deviceId, lineId, deleteCb, indicator, destination, iceGatheringConfig) {
     var _this;
     (0, _classCallCheck2.default)(this, Call);
     _this = _callSuper(this, Call);
@@ -99,6 +99,7 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
     (0, _defineProperty2.default)(_this, "rtcMetrics", void 0);
     (0, _defineProperty2.default)(_this, "callKeepaliveRetryCount", 0);
     (0, _defineProperty2.default)(_this, "apiRequest", void 0);
+    (0, _defineProperty2.default)(_this, "iceGatheringConfig", void 0);
     (0, _defineProperty2.default)(_this, "handleMediaRoapEvent", /*#__PURE__*/function () {
       var _ref = (0, _asyncToGenerator2.default)(/*#__PURE__*/_regenerator.default.mark(function _callee(event) {
         var _event$roapMessage, _event$roapMessage2;
@@ -650,6 +651,7 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
     _this.deviceId = deviceId;
     _this.serviceIndicator = indicator;
     _this.lineId = lineId;
+    _this.iceGatheringConfig = iceGatheringConfig;
 
     /* istanbul ignore else */
     if (!_this.sdkConnector.getWebex()) {
@@ -2716,8 +2718,40 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
       }
     }
   }, {
-    key: "initMediaConnection",
-    value: /* istanbul ignore next */
+    key: "getIceCandidatesTimeout",
+    value:
+    /**
+     * Determines the ICE candidate gathering timeout to use for the media connection.
+     *
+     * When the remote peer advertises itself as an ICE-lite agent (a=ice-lite) in its ROAP offer,
+     * it only provides host candidates and does not perform connectivity checks, so there is no
+     * need to wait the full ICE_CANDIDATES_TIMEOUT for local candidate gathering. In that case a
+     * shorter timeout is returned to avoid stalling media negotiation for ~3 seconds.
+     *
+     * This optimization is opt-in: it only applies when the SDK is initialized with
+     * `iceGathering.reduceTimeoutForIceLite` set to `true`. Otherwise the default
+     * ICE_CANDIDATES_TIMEOUT is always used.
+     *
+     * @returns The ICE candidates timeout in milliseconds.
+     */
+    function getIceCandidatesTimeout() {
+      var _this$iceGatheringCon, _this$remoteRoapMessa2;
+      if (!((_this$iceGatheringCon = this.iceGatheringConfig) !== null && _this$iceGatheringCon !== void 0 && _this$iceGatheringCon.reduceTimeoutForIceLite)) {
+        return _constants.ICE_CANDIDATES_TIMEOUT;
+      }
+      var remoteSdp = (_this$remoteRoapMessa2 = this.remoteRoapMessage) === null || _this$remoteRoapMessa2 === void 0 ? void 0 : _this$remoteRoapMessa2.sdp;
+      if (remoteSdp && /^a=ice-lite[\r\n]*$/im.test(remoteSdp)) {
+        var _this$iceGatheringCon2;
+        _Logger.default.info('Remote offer advertises ice-lite, using reduced ICE candidates timeout', {
+          file: _constants.CALL_FILE,
+          method: _constants.METHODS.INIT_MEDIA_CONNECTION
+        });
+        return (_this$iceGatheringCon2 = this.iceGatheringConfig.iceLiteTimeout) !== null && _this$iceGatheringCon2 !== void 0 ? _this$iceGatheringCon2 : _constants.ICE_LITE_CANDIDATES_TIMEOUT;
+      }
+      return _constants.ICE_CANDIDATES_TIMEOUT;
+    }
+
+    /* istanbul ignore next */
     /**
      * Initialize Media Connection.
      *
@@ -2725,12 +2759,14 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
      * @param settings.localAudioTrack - MediaStreamTrack.
      * @param settings.debugId - String.
      */
-    function initMediaConnection(localAudioTrack, debugId) {
+  }, {
+    key: "initMediaConnection",
+    value: function initMediaConnection(localAudioTrack, debugId) {
       var _this10 = this;
       var mediaConnection = new _internalMediaCore.RoapMediaConnection({
         skipInactiveTransceivers: true,
         iceServers: [],
-        iceCandidatesTimeout: _constants.ICE_CANDIDATES_TIMEOUT,
+        iceCandidatesTimeout: this.getIceCandidatesTimeout(),
         sdpMunging: {
           convertPort9to0: true,
           addContentSlides: false,
@@ -3416,8 +3452,8 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
       if (error.getCallError().errorLayer === _types.ERROR_LAYER.CALL_CONTROL) {
         this.metricManager.submitCallMetric(_types5.METRIC_EVENT.CALL_ERROR, transferMetricAction || this.callStateMachine.state.value.toString(), _types5.METRIC_TYPE.BEHAVIORAL, this.callId, this.correlationId, error);
       } else {
-        var _this$remoteRoapMessa2;
-        this.metricManager.submitMediaMetric(_types5.METRIC_EVENT.MEDIA_ERROR, this.mediaStateMachine.state.value.toString(), _types5.METRIC_TYPE.BEHAVIORAL, this.callId, this.correlationId, this.localRoapMessage.sdp, (_this$remoteRoapMessa2 = this.remoteRoapMessage) === null || _this$remoteRoapMessa2 === void 0 ? void 0 : _this$remoteRoapMessa2.sdp, undefined, error);
+        var _this$remoteRoapMessa3;
+        this.metricManager.submitMediaMetric(_types5.METRIC_EVENT.MEDIA_ERROR, this.mediaStateMachine.state.value.toString(), _types5.METRIC_TYPE.BEHAVIORAL, this.callId, this.correlationId, this.localRoapMessage.sdp, (_this$remoteRoapMessa3 = this.remoteRoapMessage) === null || _this$remoteRoapMessa3 === void 0 ? void 0 : _this$remoteRoapMessa3.sdp, undefined, error);
       }
     }
 
@@ -3624,7 +3660,7 @@ var Call = exports.Call = /*#__PURE__*/function (_Eventing) {
  * @param indicator - Service Indicator.
  * @param dest -.
  */
-var createCall = exports.createCall = function createCall(activeUrl, webex, dir, deviceId, lineId, deleteCb, indicator, dest) {
-  return new Call(activeUrl, webex, dir, deviceId, lineId, deleteCb, indicator, dest);
+var createCall = exports.createCall = function createCall(activeUrl, webex, dir, deviceId, lineId, deleteCb, indicator, dest, iceGatheringConfig) {
+  return new Call(activeUrl, webex, dir, deviceId, lineId, deleteCb, indicator, dest, iceGatheringConfig);
 };
 //# sourceMappingURL=call.js.map