fcr-core/lib/engine/index.js

Core APIs for building online scenes

"use strict";

require("core-js/modules/es.symbol.description.js");
require("core-js/modules/es.error.cause.js");
require("core-js/modules/esnext.function.metadata.js");
require("core-js/modules/esnext.iterator.filter.js");
require("core-js/modules/esnext.iterator.for-each.js");
require("core-js/modules/esnext.map.delete-all.js");
require("core-js/modules/esnext.map.emplace.js");
require("core-js/modules/esnext.map.every.js");
require("core-js/modules/esnext.map.filter.js");
require("core-js/modules/esnext.map.find.js");
require("core-js/modules/esnext.map.find-key.js");
require("core-js/modules/esnext.map.includes.js");
require("core-js/modules/esnext.map.key-of.js");
require("core-js/modules/esnext.map.map-keys.js");
require("core-js/modules/esnext.map.map-values.js");
require("core-js/modules/esnext.map.merge.js");
require("core-js/modules/esnext.map.reduce.js");
require("core-js/modules/esnext.map.some.js");
require("core-js/modules/esnext.map.update.js");
require("core-js/modules/esnext.symbol.metadata.js");
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
Object.defineProperty(exports, "__esModule", {
  value: true
});
exports.FcrCoreEngine = void 0;
require("core-js/modules/es.array.push.js");
require("core-js/modules/es.json.stringify.js");
require("core-js/modules/es.regexp.exec.js");
require("core-js/modules/esnext.iterator.constructor.js");
require("core-js/modules/esnext.iterator.map.js");
require("core-js/modules/web.dom-collections.iterator.js");
var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
var _imports = require("../imports");
var _api = require("../service/api");
var _monitorControl = require("../monitor-control");
var _type = require("../type");
var _desktop = require("../media-control/desktop");
var _peerSession = require("../peer-session");
var _parameters = require("../utilities/parameters");
var _error = require("../utilities/error");
var _cmd = require("../utilities/cmd");
var _type2 = require("../room-control/type");
var _chatConnection = require("../chat-connection");
var _mainroomControl = require("../room-control/mainroom-control");
var _waitingroomControl = require("../room-control/waitingroom-control");
var _ = require("..");
var _domainHolder = require("agora-rte-sdk/lib/core/services/domain-holder");
var _agoraRteSdk = require("agora-rte-sdk");
var _helper = require("agora-rte-sdk/lib/core/scene/helper");
var _mobile = require("../media-control/mobile");
var _chatroom = require("../plugins/chatroom");
var _logger = require("../utilities/logger");
var _validateParams = _interopRequireDefault(require("../utilities/validate-params"));
var _schema = require("../schema");
var _error2 = require("agora-rte-sdk/lib/core/utilities/error");
var _roomRouter = require("../room-router");
var _sharedCache = require("../room-control/shared-cache");
var _packageInfo = require("../utilities/package-info");
var _FcrCoreEngine;
let _initProto, _createMainRoomControlDecs, _createWaitingRoomControlDecs, _createRoomRouterDecs, _createRoomControlAndJoinDecs, _sendPeerMessageDecs, _setParametersDecs, _ref;
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, t, e)]; } }; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
_ref = (_createMainRoomControlDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _createWaitingRoomControlDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _createRoomRouterDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema)], _createRoomControlAndJoinDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringSchema, _schema.fcrRoomJoinOptionsSchema)], _sendPeerMessageDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringKeyUnknownValueSchema, _schema.booleanSchema, _schema.stringSchema)], _setParametersDecs = [_imports.trace, (0, _validateParams.default)(_schema.stringKeyUnknownValueSchema)], "logger");
class FcrCoreEngine {
  constructor(config) {
    // @internal
    (0, _defineProperty2.default)(this, _ref, (_initProto(this), (0, _logger.createLogger)({
      prefix: 'FcrCoreEngine'
    })));
    // @internal
    (0, _defineProperty2.default)(this, "_isLoggingIn", false);
    // @internal
    (0, _defineProperty2.default)(this, "_sharedCache", new _sharedCache.FcrSharedCache());
    // @internal
    (0, _defineProperty2.default)(this, "_lock", new _imports.Mutex());
    // @internal
    (0, _defineProperty2.default)(this, "_observable", new _imports.AgoraObservable());
    this._config = config;
    (0, _domainHolder.resetSharedDomainHolder)();
    this.logger.info('Fcr core engine is created, version: ', this.getVersion());
    const parameters = this._presetParameters(config.parameters);
    this._rteEngine = new _imports.AgoraRteEngine({
      appId: config.appId,
      userId: config.userId,
      userToken: config.token,
      rteRegion: config.region,
      rtcRegion: _imports.AgoraRtcRegion.AREA_GLOBAL,
      rtmRegion: _imports.AgoraRtmRegion.AREA_GLOBAL,
      audioConfig: {
        profile: 'default',
        scenario: 'meeting'
      },
      dualCameraVideoStreamConfig: config.dualCameraVideoStreamConfig,
      dualScreenVideoStreamConfig: config.dualScreenVideoStreamConfig,
      parameters: parameters
    });
    this._restfulClient = new _agoraRteSdk.AgoraRestfulClientImpl(this._rteEngine.getHttpAuthHeadersProvider(), (0, _imports.getSharedDomainHolder)(config.region), this._rteEngine.getRequestScheduler());
    this._apiService = new _api.FcrCoreServiceApi(this._restfulClient, config.appId, config.region, !(0, _parameters.isEndpointRegionDisabled)(config.parameters));

    // cannot be lazy loaded, because all the observers should be added before the engine is started
    this._peerSessionControl = new _peerSession.FcrPeerSessionControlImpl(this._rteEngine, this._apiService, this._config.userId);
    this._chatConnection = this._createChatConnection(config.parameters);
    this._monitorControl = new _monitorControl.FcrMonitorControlImpl(this._rteEngine, this._config);
    this._desktopMediaControl = new _desktop.FcrDesktopMediaControlImpl(this._rteEngine.getMediaControl());
    this._mobileMediaControl = new _mobile.FcrMobileMediaControlImpl(this._rteEngine.getMediaControl());
    this._addLogObserver();
    this._addRteEngineObserver();
    this._setupCoreIpList(config.parameters);
    this._setupChatConnection(config.parameters);
  }

  /**
   * Releases the engine and all its resources.
   */
  release() {
    this._rteEngine.release();
  }

  /**
   * Logins to the RTE service.
   */
  async login() {
    await this._lock.dispatch(async () => {
      if (this._isLoggingIn) {
        return;
      }
      try {
        this._isLoggingIn = true;
        this._chatConnection.login();
        await this._rteEngine.login();
      } finally {
        this._isLoggingIn = false;
        this._rteEngine.getMonitor().uploadLog({
          userUuid: this._config.userId
        });
      }
    });
  }

  /**
   * Logouts from the RTE service.
   */
  async logout() {
    await this._lock.dispatch(async () => {
      this._isLoggingIn = false;
      this._chatConnection.logout();
      await this._rteEngine.logout();
    });
  }
  /**
   * Renews the user token.
   * @param token
   */
  renewUserToken(token) {
    this._rteEngine.renewUserToken(token);
  }

  /**
   * Gets the version of the SDK.
   * @returns The version of the SDK.
   */
  getVersion() {
    return (0, _imports.getVersion)();
  }
  getDependencyVersions() {
    return _objectSpread(_objectSpread({}, this._rteEngine.getDependencyVersions()), {}, {
      rte: this._rteEngine.getVersion(),
      whiteboard: (0, _packageInfo.getDependenciesInfo)('@netless/forge-whiteboard'),
      easemob: (0, _packageInfo.getDependenciesInfo)('easemob-websdk')
    });
  }

  /**
   * Creates a room control.
   * @param roomId
   * @returns The room control.
   */
  createMainRoomControl(roomId) {
    const scene = this._rteEngine.createScene({
      sceneId: roomId
    });
    return new _mainroomControl.FcrMainRoomControlImpl(this._rteEngine, scene, this._apiService, this._config, this._sharedCache, this._chatConnection, new _chatroom.FcrChatRoomControlImpl(scene, this._chatConnection, this._sharedCache, false));
  }

  /**
   * Creates a waiting room control.
   * @param roomId
   * @returns The room control.
   */
  createWaitingRoomControl(roomId) {
    const scene = this._rteEngine.createScene({
      sceneId: roomId
    });
    return new _waitingroomControl.FcrWaitingRoomControlImpl(this._rteEngine, scene, this._apiService, this._config, this._sharedCache, this._chatConnection, new _chatroom.FcrChatRoomControlImpl(scene, this._chatConnection, this._sharedCache, false));
  }

  /**
   * Creates room router.
   * @param roomId
   * @returns The room router.
   */
  createRoomRouter(roomId) {
    const roomRouter = new _roomRouter.FcrRoomRouterImpl(this._rteEngine, this._apiService, this._config, this._chatConnection, this._sharedCache, roomId);
    return roomRouter;
  }

  /**
   * Creates a main room control or a waiting room control.
   * @param roomId
   * @returns The room control.
   */
  async createRoomControlAndJoin(roomId, options) {
    const {
      userId
    } = this._rteEngine.getConfig();
    let roomControl = null;
    let [error] = await (0, _imports.to)((0, _imports.retryAttempt)(async () => {
      const res = await (0, _error.handleRequestError)(() => {
        var _options$createStream;
        return this._apiService.checkIn({
          userName: options.userName,
          userId,
          userRole: _type.FcrUserRoleToStringMap[options.userRole],
          userProperties: options.userProperties,
          roomId,
          platform: (0, _imports.getPlatform)(),
          streams: (_options$createStream = options.createStreamConfigs) === null || _options$createStream === void 0 ? void 0 : _options$createStream.map(s => _objectSpread(_objectSpread({
            videoSourceUuid: s.videoSourceId,
            audioSourceUuid: s.audioSourceId,
            streamName: s.streamName
          }, (0, _helper.convertStreamTypeToPublishState)(s.streamType)), {}, {
            videoSourceType: s.videoSourceType,
            audioSourceType: s.audioSourceType,
            audioSourceState: s.audioSourceState,
            videoSourceState: s.videoSourceState
          })),
          version: (0, _imports.getVersion)(),
          password: options.password,
          avatar: options.avatar
        });
      }, _error.FcrErrorModuleCode.ENGINE);
      const {
        data,
        ts
      } = res;
      if (data.room.roomProperties.roomType === _type2.FcrRoomType.Waitingroom) {
        roomControl = this.createWaitingRoomControl(data.room.roomInfo.roomUuid);
      } else {
        roomControl = this.createMainRoomControl(roomId);
      }
      await roomControl.join(_objectSpread(_objectSpread({}, options), {}, {
        snapshot: data,
        timestamp: ts,
        createStreamConfigs: data.room.roomProperties.roomType === _type2.FcrRoomType.Waitingroom ? [] : options.createStreamConfigs
      }));
    }, [], {
      retriesMax: 10
    }).fail(async _ref2 => {
      let {
        error,
        timeFn,
        currentRetry
      } = _ref2;
      if ((error instanceof _error2.AgoraRteError || error instanceof _error.FcrError) && _error.ERROR_CODES_NOT_RETRYABLE_WHEN_JOINING_ROOM.includes(error.code)) {
        throw error;
      }
      this.logger.error("retry to join room, ".concat(error.message, ", retry ").concat(currentRetry, " times"));
      await timeFn();
      return true;
    }).exec());
    if (error) {
      this.logger.error("join room failed, ".concat(error.message, "-").concat(JSON.stringify(error)));
      throw error;
    }
    return roomControl;
  }

  /**
   * Gets the media control.
   * @returns The media control.
   */
  getDesktopMediaControl() {
    return this._desktopMediaControl;
  }

  /**
   * Gets the mobile media control.
   * @returns The mobile media control.
   */
  getMobileMediaControl() {
    return this._mobileMediaControl;
  }

  /**
   * Gets the monitor control.
   * @returns The monitor control.
   */
  getMonitorControl() {
    return this._monitorControl;
  }

  /**
   * Gets the peer session control.
   * @returns The peer session control.
   */
  getPeerSessionControl() {
    return this._peerSessionControl;
  }

  /**
   * Sends a peer message.
   * @param payload
   * @param guaranteedDelivery
   * @param receiverId
   */
  async sendPeerMessage(payload, guaranteedDelivery, receiverId) {
    await this._rteEngine.sendPeerMessage(payload, "".concat(_cmd.CMD_PEER_MESSAGE), guaranteedDelivery, receiverId);
  }

  /**
   * Sets the parameters.
   * @param parameters
   */
  setParameters(parameters) {
    try {
      this._setupCoreIpList(parameters);
      this._setupChatConnection(parameters);
      const {
        rte,
        rtc,
        rtm
      } = parameters;
      this._rteEngine.setParameters({
        rtc,
        rtm,
        rte
      });
    } catch (e) {
      this.logger.warn('setParameters failed', e);
    }
  }

  /**
   * Adds an observer.
   * @param observer
   */
  addObserver(observer) {
    this._rteEngine.addObserver(observer);
  }

  /**
   * Removes an observer.
   * @param observer
   */
  removeObserver(observer) {
    this._rteEngine.removeObserver(observer);
  }
  _addRteEngineObserver() {
    this._rteEngine.addObserver({
      onConnectionStateUpdated: state => {
        if (state === _.FcrConnectionState.ABORTED) {
          this.logout();
        }
      },
      onUserTokenWillExpire: () => {
        this._observable.notifyObservers('onUserTokenWillExpire');
      }
    });
  }
  _addLogObserver() {
    this.addObserver((0, _logger.generateLogObserver)(this.logger, ['onConnectionStateUpdated', 'onPeerMessageReceived', 'onUserTokenWillExpire']));
  }
  _setupCoreIpList(parameters) {
    const coreIpList = (0, _parameters.getCoreIpList)(parameters);
    if (coreIpList) {
      this.logger.info("setup fixed service domain list: ".concat(JSON.stringify(coreIpList)));
      (0, _domainHolder.resetSharedDomainHolder)();
      (0, _imports.getSharedDomainHolder)(this._config.region).setFixedDomainList(coreIpList);
      this._restfulClient = new _agoraRteSdk.AgoraRestfulClientImpl(this._rteEngine.getHttpAuthHeadersProvider(), (0, _imports.getSharedDomainHolder)(this._config.region), this._rteEngine.getRequestScheduler());
      this._apiService.setRestfulClient(this._restfulClient);
    }
  }
  _setupChatConnection(parameters) {
    const chatIpList = (0, _parameters.getEasemobChatIpList)(parameters);
    const restIpList = (0, _parameters.getEasemobRestIpList)(parameters);
    if (chatIpList && restIpList) {
      this.logger.info("setup chat ip list: ".concat(JSON.stringify(chatIpList), ", rest ip list: ").concat(JSON.stringify(restIpList)));
      this._chatConnection = this._createChatConnection(parameters);
    }
  }
  _createChatConnection(parameters) {
    const chatIpList = (0, _parameters.getEasemobChatIpList)(parameters);
    const restIpList = (0, _parameters.getEasemobRestIpList)(parameters);
    return new _chatConnection.FcrChatConnectionImpl(this._config.userId, this._apiService, chatIpList, restIpList);
  }
  _presetParameters(parameters) {
    if (!parameters) {
      parameters = {
        rtc: (0, _parameters.getRtcPresetParameters)()
      };
    } else if (!parameters.rtc) {
      parameters.rtc = (0, _parameters.getRtcPresetParameters)();
    } else {
      parameters.rtc = this._mergeRtcPresetParameters(parameters.rtc);
    }
    return parameters;
  }
  _mergeRtcPresetParameters(parametersList) {
    const rtcPresetParameters = (0, _parameters.getRtcPresetParameters)();
    parametersList.push(...rtcPresetParameters);
    return parametersList;
  }
}
exports.FcrCoreEngine = FcrCoreEngine;
_FcrCoreEngine = FcrCoreEngine;
[_initProto] = _applyDecs(_FcrCoreEngine, [[_imports.trace, 2, "release"], [_imports.trace, 2, "login"], [_imports.trace, 2, "logout"], [_imports.trace, 2, "renewUserToken"], [_imports.trace, 2, "getVersion"], [_createMainRoomControlDecs, 2, "createMainRoomControl"], [_createWaitingRoomControlDecs, 2, "createWaitingRoomControl"], [_createRoomRouterDecs, 2, "createRoomRouter"], [_createRoomControlAndJoinDecs, 2, "createRoomControlAndJoin"], [_imports.trace, 2, "getDesktopMediaControl"], [_imports.trace, 2, "getMobileMediaControl"], [_imports.trace, 2, "getMonitorControl"], [_imports.trace, 2, "getPeerSessionControl"], [_sendPeerMessageDecs, 2, "sendPeerMessage"], [_setParametersDecs, 2, "setParameters"]], []).e;