fcr-core/lib/engine/index.js

Core APIs for building online scenes

"use strict";

require("core-js/modules/es.array.push.js");
require("core-js/modules/esnext.function.metadata.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.FcrCoreEngineImpl = void 0;
require("core-js/modules/es.array.includes.js");
require("core-js/modules/es.json.stringify.js");
require("core-js/modules/esnext.iterator.constructor.js");
require("core-js/modules/esnext.iterator.map.js");
var _decorator = require("agora-foundation/lib/decorator");
var _asyncRetry = require("agora-foundation/lib/utilities/async-retry");
var _env = require("agora-foundation/lib/utilities/env");
var _errorCode = require("agora-foundation/lib/utilities/error/error-code");
var _observable = require("agora-foundation/lib/utilities/observable");
var _mutex = require("agora-foundation/lib/worker/mutex");
var _agoraRteSdk = require("agora-rte-sdk");
var _type = require("agora-rte-sdk/lib/core/rtc/type");
var _type2 = require("agora-rte-sdk/lib/core/rtm/type");
var _domainHolder = require("agora-rte-sdk/lib/core/services/domain-holder");
var _awaitToJs = _interopRequireDefault(require("await-to-js"));
var _ = require("..");
var _desktop = require("../media-control/desktop");
var _mobile = require("../media-control/mobile");
var _monitorControl = require("../monitor-control");
var _peerSession = require("../peer-session");
var _chatroom = require("../plugins/chat/chatroom");
var _connector = require("../plugins/chat/connector");
var _mainroomControl = require("../room-control/mainroom-control");
var _sharedCache = require("../room-control/shared-cache");
var _type3 = require("../room-control/type");
var _waitingroomControl = require("../room-control/waitingroom-control");
var _roomRouter = require("../room-router");
var _schema = require("../schema");
var _api = require("../service/api");
var _type4 = require("../type");
var _cmd = require("../utilities/cmd");
var _error = require("../utilities/error");
var _logger = require("../utilities/logger");
var _packageInfo = require("../utilities/package-info");
var _parameters = require("../utilities/parameters");
var _validateParams = _interopRequireDefault(require("../utilities/validate-params"));
var _infinityRoomControl = require("../room-control/infinity-room-control");
var _remoteControl = require("../remote-control");
var _convertRoomType = require("../utilities/convertRoomType");
let _initProto, _renewUserTokenDecs, _createMainRoomControlDecs, _createInfinityRoomControlDecs, _createWaitingRoomControlDecs, _createRoomRouterDecs, _createRoomControlAndJoinDecs, _sendPeerMessageDecs, _setParametersDecs;
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; }
class FcrCoreEngineImpl {
  static {
    [_initProto] = _applyDecs(this, [[_decorator.trace, 2, "release"], [_decorator.trace, 2, "login"], [_decorator.trace, 2, "logout"], [_renewUserTokenDecs, 2, "renewUserToken"], [_decorator.trace, 2, "getVersion"], [_createMainRoomControlDecs, 2, "createMainRoomControl"], [_createInfinityRoomControlDecs, 2, "createInfinityRoomControl"], [_createWaitingRoomControlDecs, 2, "createWaitingRoomControl"], [_createRoomRouterDecs, 2, "createRoomRouter"], [_createRoomControlAndJoinDecs, 2, "createRoomControlAndJoin"], [_decorator.trace, 2, "getDesktopMediaControl"], [_decorator.trace, 2, "getMobileMediaControl"], [_decorator.trace, 2, "getMonitorControl"], [_decorator.trace, 2, "getPeerSessionControl"], [_decorator.trace, 2, "getRemoteControl"], [_sendPeerMessageDecs, 2, "sendPeerMessage"], [_setParametersDecs, 2, "setParameters"]], []).e;
  }
  // @internal
  [(_renewUserTokenDecs = (0, _decorator.trace)(['token'], true), _createMainRoomControlDecs = [(0, _decorator.trace)(['roomId']), (0, _validateParams.default)(_schema.stringSchema)], _createInfinityRoomControlDecs = [(0, _decorator.trace)(['roomId']), (0, _validateParams.default)(_schema.stringSchema)], _createWaitingRoomControlDecs = [(0, _decorator.trace)(['roomId']), (0, _validateParams.default)(_schema.stringSchema)], _createRoomRouterDecs = [(0, _decorator.trace)(['roomId']), (0, _validateParams.default)(_schema.stringSchema)], _createRoomControlAndJoinDecs = [(0, _decorator.trace)(['roomId', 'options']), (0, _validateParams.default)(_schema.stringSchema, _schema.fcrRoomJoinOptionsSchema)], _sendPeerMessageDecs = [(0, _decorator.trace)(['payload', 'guaranteedDelivery', 'receiverId'], true), (0, _validateParams.default)(_schema.stringKeyUnknownValueSchema, _schema.booleanSchema, _schema.stringSchema)], _setParametersDecs = [(0, _decorator.trace)(['parameters'], true), (0, _validateParams.default)(_schema.stringKeyUnknownValueSchema)], "logger")] = void _initProto(this);
  // @internal

  // @internal

  // @internal

  // @internal

  // @internal

  // @internal

  // @internal

  // @internal

  // @internal

  // @internal
  _isLoggingIn = false;
  // @internal
  _sharedCache = new _sharedCache.FcrSharedCache();
  // @internal
  _lock = new _mutex.Mutex();
  // @internal
  _observable = new _observable.AgoraObservable();
  // @internal

  constructor(config) {
    // 确保config是一个正确的FcrCoreEngineConfig实例，以
    // 便即使调用者传递的是一个普通对象，也能始终应用_prependInternalParameters（rtc/rtm预设参数）。

    if (!(config instanceof _.FcrCoreEngineConfig)) {
      config = new _.FcrCoreEngineConfig(config);
    }
    this._config = config;
    (0, _domainHolder.resetSharedDomainHolder)();
    const rteLogFileSize = (0, _parameters.getCoreLogFileSize)(config.parameters);
    _logger.FcrCoreLoggerManagerHolder.initialize({
      maxSize: rteLogFileSize
    });
    this.logger = _logger.FcrCoreLoggerManagerHolder.createLogger({
      prefix: 'FcrCoreEngine'
    });
    this.logger.info('Fcr core engine is created, version: ', this.getVersion());
    this._rteEngine = new _agoraRteSdk.AgoraRteEngine({
      appId: config.appId,
      userId: config.userId,
      userToken: config.token,
      rteRegion: config.region,
      rtcRegion: _type.AgoraRtcRegion.AREA_GLOBAL,
      rtmRegion: _type2.AgoraRtmRegion.AREA_GLOBAL,
      audioConfig: {
        profile: 'default',
        scenario: 'meeting'
      },
      dualCameraVideoStreamConfig: config.dualCameraVideoStreamConfig,
      dualScreenVideoStreamConfig: config.dualScreenVideoStreamConfig,
      parameters: config.parameters
    });
    const domainHolder = (0, _domainHolder.getSharedDomainHolder)(config.region);
    this._restfulClient = new _agoraRteSdk.AgoraRestfulClientImpl(this._rteEngine.getHttpAuthHeadersProvider(), domainHolder, 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._remoteControl = new _remoteControl.FcrRemoteControlImpl(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();
    return _type4.FcrReturnCode.SUCCESS;
  }

  /**
   * Logins to the RTE service.
   */
  async login() {
    await this._lock.dispatch(async () => {
      if (this._isLoggingIn) {
        return _type4.FcrReturnCode.UNDEFINED;
      }
      try {
        this._isLoggingIn = true;
        this._chatConnection.login();
        return await this._rteEngine.login();
      } finally {
        this._isLoggingIn = false;
        if (this._monitorControl.needLogUpload) {
          this._rteEngine.getMonitor().uploadLog({
            userUuid: this._config.userId
          });
        } else {
          this.logger.info('log upload is disabled');
        }
      }
    });
  }

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

  /**
   * Gets the version of the SDK.
   * @returns The version of the SDK.
   */
  getVersion() {
    return (0, _packageInfo.getVersion)();
  }
  getDependencyVersions() {
    return {
      ...this._rteEngine.getDependencyVersions(),
      rte: this._rteEngine.getVersion(),
      whiteboard: (0, _packageInfo.getDependenciesInfo)('@netless/forge-whiteboard'),
      easemob: (0, _packageInfo.getDependenciesInfo)('easemob-websdk')
    };
  }
  createMainRoomControl(roomId) {
    const sceneConfig = {
      sceneId: roomId
    };
    const scene = this._rteEngine.createScene(sceneConfig);
    return new _mainroomControl.FcrMainRoomControlImpl(this._rteEngine, scene, this._apiService, this._config, this._sharedCache, this._chatConnection, new _chatroom.FcrChatRoomControlImpl(scene, this._chatConnection, this._sharedCache, false), this._monitorControl);
  }

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

  /**
   * Creates a waiting room control.
   * @param roomId
   * @returns The room control.
   */
  createWaitingRoomControl(roomId) {
    const sceneConfig = {
      sceneId: roomId
    };
    const scene = this._rteEngine.createScene(sceneConfig);
    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, this._monitorControl);
    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, _awaitToJs.default)((0, _asyncRetry.retryAttempt)(async () => {
      const res = await (0, _error.handleRequestError)(() => this._apiService.checkIn({
        userName: options.userName,
        userId,
        userRole: _type4.FcrUserRoleToStringMap[options.userRole],
        userProperties: options.userProperties,
        roomId,
        platform: (0, _env.getPlatform)(),
        streams: options.createStreamConfigs?.map(s => ({
          videoSourceUuid: s.videoSourceId,
          audioSourceUuid: s.audioSourceId,
          streamName: s.streamName,
          ...(0, _agoraRteSdk.convertStreamTypeToPublishState)(s.streamType),
          videoSourceType: s.videoSourceType,
          audioSourceType: s.audioSourceType,
          audioSourceState: s.audioSourceState,
          videoSourceState: s.videoSourceState
        })),
        version: (0, _packageInfo.getVersion)(),
        password: options.password,
        avatar: options.avatar
      }), _errorCode.ErrorModuleCode.FCR_ENGINE);
      const {
        data,
        ts
      } = res;
      const fcrRoomType = (0, _convertRoomType.convertServerRoomTypeToFcrRoomType)(data.room.roomProperties.roomType);
      switch (fcrRoomType) {
        case _type3.FcrRoomType.Waitingroom:
          roomControl = this.createWaitingRoomControl(data.room.roomInfo.roomUuid);
          break;
        case _type3.FcrRoomType.Infinityroom:
          roomControl = this.createInfinityRoomControl(roomId);
          break;
        case _type3.FcrRoomType.Mainroom:
          roomControl = this.createMainRoomControl(roomId);
          break;
        default:
          throw new Error(`Unknown room type: ${fcrRoomType}`);
      }
      await roomControl.join({
        ...options,
        snapshot: data,
        timestamp: ts,
        createStreamConfigs: fcrRoomType === _type3.FcrRoomType.Waitingroom ? [] : options.createStreamConfigs
      });
    }, [], {
      retriesMax: 10
    }).fail(async ({
      error,
      timeFn,
      currentRetry
    }) => {
      if (error instanceof _error.FcrError && _error.ERROR_CODES_NOT_RETRYABLE_WHEN_JOINING_ROOM.includes(error.code)) {
        throw error;
      }
      this.logger.error(`retry to join room, ${error.message}, retry ${currentRetry} times`);
      await timeFn();
      return true;
    }).exec());
    if (error) {
      this.logger.error(`join room failed, ${error.message}-${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;
  }

  /**
   * Gets the remote control.
   * @returns The remote control.
   */
  getRemoteControl() {
    return this._remoteControl;
  }

  /**
   * Sends a peer message.
   * @param payload
   * @param guaranteedDelivery
   * @param receiverId
   */
  async sendPeerMessage(payload, guaranteedDelivery, receiverId) {
    return await this._rteEngine.sendPeerMessage(payload, `${_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;
      return this._rteEngine.setParameters({
        rtc,
        rtm,
        rte
      });
    } catch (e) {
      this.logger.warn('setParameters failed', e);
      return _type4.FcrReturnCode.UNDEFINED;
    }
  }

  /**
   * 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', ['state']], ['onPeerMessageReceived', ['message']], 'onUserTokenWillExpire']));
  }
  _setupCoreIpList(parameters) {
    const coreIpList = (0, _parameters.getCoreIpList)(parameters);
    if (coreIpList) {
      this.logger.info(`setup fixed service domain list: ${JSON.stringify(coreIpList)}`);
      (0, _domainHolder.resetSharedDomainHolder)();
      (0, _domainHolder.getSharedDomainHolder)(this._config.region).setFixedDomainList(coreIpList);
      this._restfulClient = new _agoraRteSdk.AgoraRestfulClientImpl(this._rteEngine.getHttpAuthHeadersProvider(), (0, _domainHolder.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: ${JSON.stringify(chatIpList)}, rest ip list: ${JSON.stringify(restIpList)}`);
      this._chatConnection = this._createChatConnection(parameters);
    }
  }
  _createChatConnection(parameters) {
    const chatIpList = (0, _parameters.getEasemobChatIpList)(parameters);
    const restIpList = (0, _parameters.getEasemobRestIpList)(parameters);
    return new _connector.FcrChatConnectorImpl(this._config.userId, this._apiService, chatIpList, restIpList);
  }
}
exports.FcrCoreEngineImpl = FcrCoreEngineImpl;