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.array.push.js");
require("core-js/modules/esnext.async-iterator.filter.js");
require("core-js/modules/esnext.async-iterator.for-each.js");
require("core-js/modules/esnext.function.metadata.js");
require("core-js/modules/esnext.iterator.constructor.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.error.cause.js");
require("core-js/modules/es.json.stringify.js");
require("core-js/modules/es.regexp.exec.js");
require("core-js/modules/esnext.async-iterator.map.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 _packageInfo = require("../utilities/package-info");
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 _whiteboardControlV = require("../room-control/whiteboard-control-v2");
var _logger = require("../utilities/logger");
var _FcrCoreEngine;
let _initProto;
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; }
class FcrCoreEngine {
  constructor(config) {
    var _config$parameters, _config$parameters2, _config$parameters3;
    // @internal
    (0, _defineProperty2.default)(this, "logger", (_initProto(this), (0, _logger.getLogger)()));
    // @internal
    (0, _defineProperty2.default)(this, "_isLoggingIn", false);
    this._config = config;
    (0, _domainHolder.resetSharedDomainHolder)();
    this._rteEngine = new _imports.AgoraRteEngine({
      appId: config.appId,
      userId: config.userId,
      token: config.token,
      rteRegion: config.region,
      rtcRegion: _imports.AgoraRtcRegion.AREA_GLOBAL,
      rtmRegion: _imports.AgoraRtmRegion.AREA_GLOBAL,
      dualCameraVideoStreamConfig: config.dualCameraVideoStreamConfig,
      dualScreenVideoStreamConfig: config.dualScreenVideoStreamConfig,
      parameters: {
        rte: (_config$parameters = config.parameters) === null || _config$parameters === void 0 ? void 0 : _config$parameters.rte,
        rtc: (_config$parameters2 = config.parameters) === null || _config$parameters2 === void 0 ? void 0 : _config$parameters2.rtc,
        rtm: (_config$parameters3 = config.parameters) === null || _config$parameters3 === void 0 ? void 0 : _config$parameters3.rtm
      }
    });
    const restfulClient = new _agoraRteSdk.AgoraRestfulClientImpl(this._rteEngine.getHttpAuthHeadersProvider(), (0, _imports.getSharedDomainHolder)(config.region));
    this._apiService = new _api.FcrCoreServiceApi(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 = new _chatConnection.FcrChatConnectionImpl(this._config, this._apiService);
    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();
    const coreIpList = (0, _parameters.getCoreIpList)(config.parameters);
    if (coreIpList) {
      this.logger.info("[FcrCoreEngine] set fixed domain list: ".concat(JSON.stringify(coreIpList)));
      (0, _imports.getSharedDomainHolder)(this._config.region).setFixedDomainList(coreIpList);
    }
  }

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

  /**
   * Logins to the RTE service.
   */
  async login() {
    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() {
    this._isLoggingIn = false;
    this._chatConnection.logout();
    await this._rteEngine.logout();
  }

  /**
   * Gets the version of the SDK.
   * @returns The version of the SDK.
   */
  getVersion() {
    return (0, _packageInfo.getVersion)();
  }

  /**
   * 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, _type2.FcrRoomType.Mainroom, this._chatConnection, new _chatroom.FcrChatRoomControlImpl(scene, this._chatConnection), new _whiteboardControlV.FcrWhiteboardControlImpl(scene, this._apiService, this._rteEngine));
  }

  /**
   * 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, _type2.FcrRoomType.Waitingroom, this._chatConnection, new _chatroom.FcrChatRoomControlImpl(scene, this._chatConnection));
  }

  /**
   * 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 res = undefined;
    const [error] = await (0, _imports.to)((0, _imports.retryAttempt)(async () => {
      var _options$createStream;
      res = await 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, _packageInfo.getVersion)(),
        password: options.password
      });
    }, [], {
      retriesMax: 3
    }).fail(async _ref => {
      let {
        error,
        timeFn,
        currentRetry
      } = _ref;
      if (error instanceof _imports.AgoraRestfulClientError) {
        throw error;
      }
      this.logger.error("[RoomControl] retry to check in room, ".concat(error.message, ",retry ").concat(currentRetry, " times"));
      await timeFn();
      return true;
    }).exec());
    if (error) {
      this.logger.error("[RoomControl] check in room failed, ".concat(error.message, "-").concat(JSON.stringify(error)));
      if (error instanceof _imports.AgoraRestfulClientError) {
        if (error.httpCode < 100) {
          throw (0, _error.generateFcrCoreClientError)(_error.FcrErrorModuleCode.ROOM, _error.FcrErrorCode.LOCAL_HTTP_REQUEST_FAILED, "entry room failed, ".concat(error.message), error);
        } else {
          var _error$serviceCode;
          throw (0, _error.generateFcrCoreServerError)((_error$serviceCode = error.serviceCode) !== null && _error$serviceCode !== void 0 ? _error$serviceCode : -1, error.message, error);
        }
      }
      throw (0, _error.generateFcrCoreClientError)(_error.FcrErrorModuleCode.ROOM, _error.FcrErrorCode.UNDEFINED_ERROR, 'join room failed', error);
    }
    if (!res) {
      this.logger.error("[RoomControl] cannot get data from check in respnose");
      throw (0, _error.generateFcrCoreClientError)(_error.FcrErrorModuleCode.ROOM, _error.FcrErrorCode.UNDEFINED_ERROR, 'join room failed', new Error('cannot get data from check in respnose'));
    }
    const {
      data,
      ts
    } = res;
    // console.log('data.room.roomProperties.roomType', data.room.roomProperties.roomType);

    let roomControl = null;
    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
    }));
    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) {
    const {
      rte,
      rtc,
      rtm
    } = parameters;
    try {
      this._rteEngine.setParameters({
        rtc: rtc && JSON.stringify(rtc),
        rtm: rtm && JSON.stringify(rtm),
        rte: rte
      });
    } catch (e) {
      this.logger.warn('[FcrCoreEngine] 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();
        }
      }
    });
  }
  _addLogObserver() {
    this.addObserver((0, _logger.generateLogObserver)(this.logger, ['onConnectionStateUpdated', 'onPeerMessageReceived']));
  }
}
exports.FcrCoreEngine = FcrCoreEngine;
_FcrCoreEngine = FcrCoreEngine;
[_initProto] = _applyDecs(_FcrCoreEngine, [[_logger.trace, 2, "release"], [_logger.trace, 2, "login"], [_logger.trace, 2, "logout"], [_logger.trace, 2, "getVersion"], [_logger.trace, 2, "createMainRoomControl"], [_logger.trace, 2, "createWaitingRoomControl"], [_logger.trace, 2, "createRoomControlAndJoin"], [_logger.trace, 2, "getDesktopMediaControl"], [_logger.trace, 2, "getMobileMediaControl"], [_logger.trace, 2, "getMonitorControl"], [_logger.trace, 2, "getPeerSessionControl"], [_logger.trace, 2, "sendPeerMessage"], [_logger.trace, 2, "setParameters"]], []).e;