fcr-core 3.8.1 → 3.9.0-alpha

package/lib-es/room-control/interpreter-control/index.js

@@ -0,0 +1,172 @@
+import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.map.delete-all.js";
+import "core-js/modules/esnext.map.emplace.js";
+import "core-js/modules/esnext.map.every.js";
+import "core-js/modules/esnext.map.filter.js";
+import "core-js/modules/esnext.map.find.js";
+import "core-js/modules/esnext.map.find-key.js";
+import "core-js/modules/esnext.map.includes.js";
+import "core-js/modules/esnext.map.key-of.js";
+import "core-js/modules/esnext.map.map-keys.js";
+import "core-js/modules/esnext.map.map-values.js";
+import "core-js/modules/esnext.map.merge.js";
+import "core-js/modules/esnext.map.reduce.js";
+import "core-js/modules/esnext.map.some.js";
+import "core-js/modules/esnext.map.update.js";
+import "core-js/modules/esnext.symbol.metadata.js";
+let _initProto, _createRoomControlDecs, _setInterpreterUsersDecs;
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.map.js";
+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; }
+import { AgoraObservable, get, trace } from '../../imports';
+import { FcrInterpreterRoomControlImpl } from './room';
+import { FcrInterpreterActionType } from './types';
+import { FcrReturnCode } from '../../type';
+import { convertRteUserToFcrUser } from '../../utilities/user';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { handleRequestError } from '../../utilities/error';
+import validateParams from '../../utilities/validate-params';
+import { fcrInterpreterUsersParamsArraySchema, stringSchema } from '../../schema';
+import { ErrorModuleCode } from '../../imports';
+
+/**
+ * @internal
+ */
+export class FcrInterpreterControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[_createRoomControlDecs, 2, "createRoomControl"], [_setInterpreterUsersDecs, 2, "setInterpreterUsers"], [trace, 2, "close"], [trace, 2, "getState"], [trace, 2, "getInterpreterRoomList"], [trace, 2, "getInterpreterLanguageList"]], []).e;
+  }
+  //@internal
+  [(_createRoomControlDecs = [trace(['roomId']), validateParams(stringSchema)], _setInterpreterUsersDecs = [trace(['params']), validateParams(fcrInterpreterUsersParamsArraySchema)], "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrInterpreterControlImpl'
+  }));
+  _observable = new AgoraObservable();
+  _interpreterUserList = null;
+  constructor(_api, _scene, _config, _engine, _chatConnection, _sharedCache) {
+    this._api = _api;
+    this._scene = _scene;
+    this._config = _config;
+    this._engine = _engine;
+    this._chatConnection = _chatConnection;
+    this._sharedCache = _sharedCache;
+    this._roomCache = _sharedCache.getRoomCache(this._scene.sceneId);
+    this._roomId = this._scene.sceneId;
+    this._addInterpreterObservers();
+    this._addLogObserver();
+  }
+  createRoomControl(roomId) {
+    return new FcrInterpreterRoomControlImpl(this._engine, this._engine.createScene({
+      sceneId: roomId
+    }), this._api, this._config, this._sharedCache, this._chatConnection);
+  }
+  async setInterpreterUsers(params) {
+    await handleRequestError(() => this._api.openInterpreter({
+      roomId: this._roomId,
+      data: {
+        interpreters: params.map(({
+          userId: userUuid,
+          sourceLanguage,
+          targetLanguage
+        }) => {
+          return {
+            userUuid,
+            languagePair: [sourceLanguage, targetLanguage]
+          };
+        })
+      }
+    }), ErrorModuleCode.FCR_ROOM_INTERPRETER, 'set interpreterUsers failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async close() {
+    await handleRequestError(() => this._api.closeInterpreter({
+      roomId: this._roomId
+    }), ErrorModuleCode.FCR_ROOM_INTERPRETER, 'close interpreter failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  getState() {
+    const enable = this._scene.getScenePropertiesByKeyPath('interpreter.enable');
+    return {
+      enable: enable === 1
+    };
+  }
+  getInterpreterRoomList() {
+    const rooms = this._scene.getScenePropertiesByKeyPath('interpreter.rooms') || [];
+    return rooms.length > 0 ? rooms.map(({
+      roomUuid,
+      language
+    }) => ({
+      roomId: roomUuid,
+      language
+    })) : null;
+  }
+  _setInterpreterUserList() {
+    const interpreter = this._scene.getScenePropertiesByKeyPath('interpreter');
+    const {
+      translates
+    } = interpreter || {
+      translates: []
+    };
+    const results = translates.map(({
+      userUuid: userId,
+      userName,
+      languagePair: [sourceLanguage, targetLanguage]
+    }) => ({
+      userId,
+      userName,
+      sourceLanguage,
+      targetLanguage
+    }));
+    this._interpreterUserList = results.length > 0 ? results : null;
+  }
+  getInterpreterUserList() {
+    return this._interpreterUserList;
+  }
+  getInterpreterLanguageList() {
+    const languages = this._scene.getScenePropertiesByKeyPath('interpreter.languages');
+    return languages;
+  }
+  addObserver(observer) {
+    this._observable.addObserver(observer);
+  }
+  removeObserver(observer) {
+    this._observable.removeObserver(observer);
+  }
+  _addInterpreterObservers() {
+    this._scene.addObserver({
+      onScenePropertiesUpdated: (_, event) => {
+        if (event.cause?.cmd === 800) {
+          const actionType = get(event.cause.data, 'actionType');
+          let operatorUser;
+          if (event.operatorUser) {
+            operatorUser = convertRteUserToFcrUser(event.operatorUser, this._roomCache);
+          }
+          const isStateUpdated = [FcrInterpreterActionType.OPEN, FcrInterpreterActionType.CLOSE].includes(actionType);
+          const isUpdated = [
+          // FcrInterpreterActionType.OPEN,
+          FcrInterpreterActionType.UPDATE].includes(actionType);
+          if (isStateUpdated || isUpdated) {
+            this._setInterpreterUserList();
+          }
+          if (isStateUpdated) {
+            this._observable.notifyObservers('onInterpreterStateUpdated', this._roomId, this.getState(), operatorUser);
+          }
+          if (isUpdated) {
+            this._observable.notifyObservers('onInterpreterUsersUpdated', this._roomId, this.getInterpreterUserList(), operatorUser);
+            this._observable.notifyObservers('onInterpreterRoomListUpdated', this._roomId, this.getInterpreterRoomList(), operatorUser);
+          }
+        }
+      },
+      onJoinSceneSuccess: () => {
+        this._setInterpreterUserList();
+      }
+    });
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onInterpreterStateUpdated', ['roomId', 'state', 'operatorUser']], ['onInterpreterUsersUpdated', ['roomId', 'users', 'operatorUser']], ['onInterpreterRoomListUpdated', ['roomId', 'rooms', 'operatorUser']]]));
+  }
+}

package/lib-es/room-control/interpreter-control/room.js

@@ -0,0 +1,28 @@
+import { FcrBaseRoomControlImpl } from '..';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { FcrRoomType } from '../type';
+/**
+ * @internal
+ */
+export class FcrInterpreterRoomControlImpl extends FcrBaseRoomControlImpl {
+  //@internal
+  logger = createLogger({
+    prefix: 'FcrInterpreterRoomControlImpl'
+  });
+  constructor(_engine, _scene, _api, _config, _sharedCache, _chatConnection, chatRoomControl) {
+    super(_engine, _scene, _api, _config, FcrRoomType.Interpreterroom, _chatConnection, _sharedCache, chatRoomControl);
+    this._engine = _engine;
+    this._scene = _scene;
+    this._api = _api;
+    this._config = _config;
+    this._sharedCache = _sharedCache;
+    this._chatConnection = _chatConnection;
+    this._addLogObserver();
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onCloudRecordingStateUpdated', ['roomId', 'state']], ['onJoinRoomFailure', ['roomId', 'error']], ['onJoinRoomSuccess', ['roomId']], ['onLiveStreamingStateUpdated', ['roomId', 'state', 'url', 'reason']],
+    // 'onNetworkQualityUpdated',
+    // 'onNetworkStatsUpdated',
+    ['onRoomMessageReceived', ['roomId', 'message']], ['onRoomPropertiesDeleted', ['roomId', 'event']], ['onRoomPropertiesUpdated', ['roomId', 'event']], ['onRoomStateUpdated', ['roomId', 'state']]]));
+  }
+}

package/lib-es/room-control/interpreter-control/types.js

@@ -0,0 +1,26 @@
+export let FcrLanguage = /*#__PURE__*/function (FcrLanguage) {
+  FcrLanguage["ZH"] = "zh";
+  FcrLanguage["EN"] = "en";
+  FcrLanguage["JP"] = "jp";
+  FcrLanguage["KO"] = "ko";
+  FcrLanguage["DE"] = "de";
+  FcrLanguage["FR"] = "fr";
+  FcrLanguage["RU"] = "ru";
+  FcrLanguage["PT"] = "pt";
+  FcrLanguage["ES"] = "es";
+  FcrLanguage["IT"] = "it";
+  FcrLanguage["AR"] = "ar";
+  FcrLanguage["ID"] = "id";
+  FcrLanguage["HI"] = "hi";
+  FcrLanguage["TH"] = "th";
+  FcrLanguage["VI"] = "vi";
+  FcrLanguage["MS"] = "ms";
+  FcrLanguage["TR"] = "tr";
+  return FcrLanguage;
+}({});
+export let FcrInterpreterActionType = /*#__PURE__*/function (FcrInterpreterActionType) {
+  FcrInterpreterActionType[FcrInterpreterActionType["OPEN"] = 1] = "OPEN";
+  FcrInterpreterActionType[FcrInterpreterActionType["UPDATE"] = 2] = "UPDATE";
+  FcrInterpreterActionType[FcrInterpreterActionType["CLOSE"] = 3] = "CLOSE";
+  return FcrInterpreterActionType;
+}({});

package/lib-es/room-control/join-before-host-waitingroom-control/index.js

@@ -0,0 +1,29 @@
+import { FcrBaseRoomControlImpl } from '..';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { FcrRoomType } from '../type';
+
+/**
+ * @internal
+ */
+export class FcrJoinBeforeHostWaitingRoomControlImpl extends FcrBaseRoomControlImpl {
+  //@internal
+  logger = createLogger({
+    prefix: 'FcrJoinBeforeHostWaitingRoomControlImpl'
+  });
+  constructor(engine, scene, api, config, sharedCache, chatConnection, chatRoomControl) {
+    super(engine, scene, api, config, FcrRoomType.JoinBeforeHostWaitingRoom, chatConnection, sharedCache, chatRoomControl);
+    this._addLogObserver();
+  }
+  addObserver(observer) {
+    super.addObserver(observer);
+  }
+  removeObserver(observer) {
+    super.removeObserver(observer);
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onCloudRecordingStateUpdated', ['roomId', 'state']], ['onJoinRoomFailure', ['roomId', 'error']], ['onJoinRoomSuccess', ['roomId']], ['onLiveStreamingStateUpdated', ['roomId', 'state', 'url', 'reason']],
+    // 'onNetworkQualityUpdated',
+    // 'onNetworkStatsUpdated',
+    ['onRoomMessageReceived', ['roomId', 'message']], ['onRoomPropertiesDeleted', ['roomId', 'event']], ['onRoomPropertiesUpdated', ['roomId', 'event']], ['onRoomStateUpdated', ['roomId', 'state']]]));
+  }
+}

package/lib-es/room-control/mainroom-control/index.js

@@ -0,0 +1,248 @@
+import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.map.delete-all.js";
+import "core-js/modules/esnext.map.emplace.js";
+import "core-js/modules/esnext.map.every.js";
+import "core-js/modules/esnext.map.filter.js";
+import "core-js/modules/esnext.map.find.js";
+import "core-js/modules/esnext.map.find-key.js";
+import "core-js/modules/esnext.map.includes.js";
+import "core-js/modules/esnext.map.key-of.js";
+import "core-js/modules/esnext.map.map-keys.js";
+import "core-js/modules/esnext.map.map-values.js";
+import "core-js/modules/esnext.map.merge.js";
+import "core-js/modules/esnext.map.reduce.js";
+import "core-js/modules/esnext.map.some.js";
+import "core-js/modules/esnext.map.update.js";
+import "core-js/modules/esnext.symbol.metadata.js";
+let _initProto, _enableWaitingRoomDecs, _moveToWaitingRoomByUserIdsDecs;
+import "core-js/modules/es.json.stringify.js";
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.find.js";
+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; }
+import { FcrBaseRoomControlImpl } from '..';
+import { AgoraRestfulClientError, AgoraScheduler, bound, DetailErrorCode, ErrorModuleCode, get, jsonstring, to, trace } from '../../imports';
+import { booleanSchema, stringArraySchema } from '../../schema';
+import { FcrPlatform, FcrReturnCode, FcrUserRole, FcrUserRoleToStringMap, FcrVideoSourceType } from '../../type';
+import { generateFcrCoreClientError, generateFcrCoreServerError, handleRequestError } from '../../utilities/error';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { clearAnnotationBoardOptions, clearWhiteboardOptions, setAnnotationBoardOptions, setWhiteboardOptions } from '../../utilities/shared-storage';
+import validateParams from '../../utilities/validate-params';
+import { FcrGroupControl } from '../group-control';
+import { FcrInterpreterControlImpl } from '../interpreter-control';
+import { FcrRoomType } from '../type';
+import { getAnnotationConfigFromRoomProperties } from '../whiteboard-control-v2/utils';
+import { hasAnnotationWritePermission, hasBoardWritePermission } from '../whiteboard-control/utils';
+const {
+  shared: sharedScheduler,
+  Duration
+} = AgoraScheduler;
+/**
+ * @internal
+ */
+export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[trace, 2, "join"], [trace, 2, "leave"], [_enableWaitingRoomDecs, 2, "enableWaitingRoom"], [_moveToWaitingRoomByUserIdsDecs, 2, "moveToWaitingRoomByUserIds"], [trace, 2, "moveToWaitingRoomByUserRoles"], [bound, 2, "_onLocalUserPermissionInfoAdded"], [bound, 2, "_onLocalUserPermissionInfoDeleted"]], [], 0, void 0, FcrBaseRoomControlImpl).e;
+  }
+  //@internal
+  [(_enableWaitingRoomDecs = [trace(['enable']), validateParams(booleanSchema)], _moveToWaitingRoomByUserIdsDecs = [trace(['userIds']), validateParams(stringArraySchema)], "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrMainRoomControlImpl'
+  }));
+  _privilegeObserver = {
+    onLocalUserPermissionInfoAdded: this._onLocalUserPermissionInfoAdded,
+    onLocalUserPermissionInfoDeleted: this._onLocalUserPermissionInfoDeleted
+  };
+  constructor(engine, scene, api, config, sharedCache, chatConnection, chatRoomControl) {
+    super(engine, scene, api, config, FcrRoomType.Mainroom, chatConnection, sharedCache, chatRoomControl);
+    this._groupControl = new FcrGroupControl(engine, scene, api, sharedCache);
+    this._interpreterControl = new FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
+    this._addLogObserver();
+    this._scene.addObserver({
+      onScenePropertiesUpdated: (sceneId, event) => {
+        const annotationBoardAppId = get(event.changedProperties, 'widgets.annotation.extra.boardAppId');
+        if (annotationBoardAppId) {
+          this.logger.info('widgets.annotation.extra.boardAppId updated, re-initializing annotation info');
+          this._initAnnotationInfo();
+        }
+        const whiteboardBoardAppId = get(event.changedProperties, 'widgets.netlessBoard.extra.boardAppId');
+        if (whiteboardBoardAppId) {
+          this.logger.info('widgets.netlessBoard.extra.boardAppId updated, re-initializing whiteboard info');
+          this._initBoardInfo();
+        }
+      },
+      onJoinSceneSuccess: () => {
+        this.logger.info('join scene success, re-initializing annotation and whiteboard info');
+        this._initAnnotationInfo();
+        this._initBoardInfo();
+      }
+    });
+    this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
+  }
+
+  // @trace
+  getInterpreterControl() {
+    return this._interpreterControl;
+  }
+
+  // @trace
+  getGroupControl() {
+    return this._groupControl;
+  }
+  async join(options) {
+    try {
+      clearAnnotationBoardOptions();
+      clearWhiteboardOptions();
+      await super.join(options);
+      const privilegeControl = this.getPrivilegeControl();
+      privilegeControl.addObserver(this._privilegeObserver);
+      const task = sharedScheduler.addIntervalTask(() => {
+        this._engine.getMonitor().uploadLog({
+          userUuid: this._config.userId,
+          roomUuid: this._scene.sceneId
+        });
+      }, Duration.minute(5), false);
+      this._logUploadTask = task;
+      return FcrReturnCode.SUCCESS;
+    } finally {
+      this._engine.getMonitor().uploadLog({
+        userUuid: this._config.userId,
+        roomUuid: this._scene.sceneId
+      });
+    }
+  }
+  async leave() {
+    try {
+      const privilegeControl = this.getPrivilegeControl();
+      privilegeControl.removeObserver(this._privilegeObserver);
+      return await super.leave();
+    } finally {
+      this._logUploadTask?.stop();
+      this._engine.getMonitor().uploadLog({
+        userUuid: this._config.userId,
+        roomUuid: this._scene.sceneId
+      });
+    }
+  }
+  addObserver(observer) {
+    super.addObserver(observer);
+  }
+  removeObserver(observer) {
+    super.removeObserver(observer);
+  }
+  async enableWaitingRoom(enable) {
+    return handleRequestError(() => this._api.enableWaitingRoom({
+      enable,
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM, 'enable waiting room failed');
+  }
+  async moveToWaitingRoomByUserIds(userIds) {
+    const [error] = await to(this._api.moveToWaitingRoomByUserIds(userIds, this._scene.sceneId));
+    if (error) {
+      this.logger.error(`[RoomControl] move to waiting room failed, ${error.message}-${JSON.stringify(error)}`);
+      if (error instanceof AgoraRestfulClientError) {
+        throw generateFcrCoreServerError(error.serviceCode ?? -1, error.message, error);
+      }
+      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, 'move to waiting room failed', error);
+    }
+    return FcrReturnCode.SUCCESS;
+  }
+  async moveToWaitingRoomByUserRoles() {
+    return this._api.moveToWaitingRoomByUserRoles([FcrUserRoleToStringMap[FcrUserRole.PARTICIPANT]], this._scene.sceneId);
+  }
+  async _initAnnotationInfo() {
+    const roomId = this._scene.sceneId;
+    const userId = this._scene.localUser.getLocalUserId();
+    const boardOptions = (await this._getToken(roomId, userId)).data;
+    if (!boardOptions) {
+      this.logger.error(`get annotation board options failed, roomId: ${roomId}, userId: ${userId}, boardOptions: ${jsonstring(boardOptions)}`);
+    } else {
+      this.logger.info(`get annotation board options success, roomId: ${roomId}, userId: ${userId}, boardOptions: ${jsonstring(boardOptions)}`);
+      setAnnotationBoardOptions(boardOptions);
+    }
+  }
+  async _initBoardInfo() {
+    const roomId = this._scene.sceneId;
+    const userId = this._scene.localUser.getLocalUserId();
+    const boardOptions = (await this._getBoardToken(roomId, userId)).data;
+    if (!boardOptions) {
+      this.logger.error(`get whiteboard options failed, roomId: ${roomId}, userId: ${userId}, boardOptions: ${jsonstring(boardOptions)}`);
+    } else {
+      this.logger.info(`get whiteboard options success, roomId: ${roomId}, userId: ${userId}, boardOptions: ${jsonstring(boardOptions)}`);
+      setWhiteboardOptions(boardOptions);
+    }
+  }
+  async _getToken(roomId, userId) {
+    return await handleRequestError(() => this._api.getAnnotationToken({
+      roomId,
+      userId
+    }), ErrorModuleCode.FCR_ROOM_WHITEBOARD, 'get whiteboard token failed');
+  }
+  async _getBoardToken(roomId, userId) {
+    return await handleRequestError(() => this._api.getWhiteboardToken({
+      roomId,
+      userId
+    }), ErrorModuleCode.FCR_ROOM_WHITEBOARD, 'get whiteboard token failed');
+  }
+  _onLocalUserPermissionInfoAdded(roomId, event) {
+    if (hasBoardWritePermission(event.permissionInfo)) {
+      this.logger.info(`add board write permission`);
+      this.getSharingControl().getBoardControl().setOperationPrivilege(true);
+    }
+    if (hasAnnotationWritePermission(event.permissionInfo)) {
+      this.logger.info(`add annotation write permission`);
+      this.getSharingControl().getAnnotationControl().setOperationPrivilege(true);
+    }
+  }
+  _onLocalUserPermissionInfoDeleted(roomId, event) {
+    if (hasBoardWritePermission(event.permissionInfo)) {
+      this.logger.info(`remove board write permission`);
+      this.getSharingControl().getBoardControl().setOperationPrivilege(false);
+    }
+    if (hasAnnotationWritePermission(event.permissionInfo)) {
+      this.logger.info(`remove annotation write permission`);
+      this.getSharingControl().getAnnotationControl().setOperationPrivilege(false);
+    }
+  }
+  _checkIfUpdateAnnotationMainWindow() {
+    const streamControl = this.getStreamControl();
+    const userControl = this.getUserControl();
+    const mainWindow = this.getSharingControl().getAnnotationControl().getMainWindow();
+    const annotationConfig = getAnnotationConfigFromRoomProperties(this._scene.getSceneProperties(), this.logger);
+    if (mainWindow) {
+      const stream = streamControl.getStreamList().find(stream => stream.videoSourceType === FcrVideoSourceType.SCREEN);
+      const localUserId = userControl.getLocalUser().userId;
+      if (stream) {
+        const ownerId = stream.owner.userId;
+        const isNotMeSharing = ownerId !== localUserId;
+        const platform = userControl.getUser(ownerId)?.platform;
+        const isPcPlatform = platform && [FcrPlatform.WEB_DESKTOP, FcrPlatform.WINDOWS, FcrPlatform.MACOS].includes(platform);
+        const isAndroidPlatform = platform && platform === FcrPlatform.ANDROID;
+        this.logger.info(`check if set auto cancel draw, isPcPlatform: ${isPcPlatform}, isAndroidPlatform: ${isAndroidPlatform}, isNotMeSharing: ${isNotMeSharing}, ownerId: ${ownerId}, localUserId: ${localUserId}, platform: ${platform}`);
+        if (isPcPlatform) {
+          mainWindow.setAutoCancelDraw(false);
+        }
+        if (isAndroidPlatform) {
+          mainWindow.setAutoCancelDraw(isNotMeSharing);
+        }
+        if (!isNotMeSharing) {
+          mainWindow.clean();
+          mainWindow.updateWindowSize({
+            width: annotationConfig.size.width,
+            height: annotationConfig.size.height
+          });
+          this._api.syncScreenShareOwnerAnnotationOpenDone(this._scene.sceneId);
+        }
+      }
+    }
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onCloudRecordingStateUpdated', ['roomId', 'state']], ['onJoinRoomFailure', ['roomId', 'error']], ['onJoinRoomSuccess', ['roomId']], ['onLiveStreamingStateUpdated', ['roomId', 'state', 'url', 'reason']],
+    // 'onNetworkQualityUpdated',
+    // 'onNetworkStatsUpdated',
+    ['onRoomMessageReceived', ['roomId', 'message']], ['onRoomPropertiesDeleted', ['roomId', 'event']], ['onRoomPropertiesUpdated', ['roomId', 'event']], ['onRoomStateUpdated', ['roomId', 'state']]]));
+  }
+}

package/lib-es/room-control/privilege-control/helper.js

@@ -0,0 +1,97 @@
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.find.js";
+import "core-js/modules/esnext.iterator.map.js";
+// 初始化权限策略表达式：{module}:{action}-{k1=v1|v2;k2=v3}>{role1|role2}
+// {module}表示模块，如房间模块room、用户模块user、发流模块stream等。
+// {action}表示操作，如结束房间、静音、开启视频等。
+// {k1=v1|v2;k2=v3}表示操作的个性化入参，如设置成联席主持人权限，user:setRole-role=host|co-host，入参为role=host|co-host，相同key用｜隔开，多个key用;隔开。
+// {role1|role2}表示操作对象所属的角色，对象可以是多个，中间用｜隔开，如要表示对participant和co-host拥有静音的权限，stream:muteAudio>participant|co-host
+// 如果操作对象的类型是用户，则需要指定目标角色；如果操作对象的类型是房间，则不需要指定目标角色。
+// 为简化表达式，*表示所有，~表示自己（要不要给这种简便的表达式？前端是否不好识别，但如果没有，配置是否有点复杂）
+// 举例：
+// stream:muteAudio>~ ，表示可以对自己静音，stream:muteAudio>participant，表示对观众禁音
+// user:kickout>* ，表示可以踢所有角色
+// record:* ，表示有录制模块下所有操作
+// *:*>*，表示拥有对房间最大权限
+// {action}分为两类：操作权限和可赋予的操作权限，可赋予的操作权限又分为授权和取消授权
+
+import { FcrOperatePermissionType } from './type';
+import { checkFcrUserRole, convertRteUserToFcrUser, convertStringPrivilegeRoleToFcrPrivilegeRole } from '../../utilities/user';
+export class FcrPermission {
+  constructor(module, action, conditions, targetRoles) {
+    this.module = module;
+    this.action = action;
+    this.conditions = conditions;
+    this.targetRoles = targetRoles;
+  }
+  static fromString(permission) {
+    const [moduleActionParams, roles] = permission.split('>');
+    const [moduleAction, params] = moduleActionParams.split('-');
+    const [module, action] = moduleAction.split(':');
+    const paramsObj = {};
+    if (params) {
+      for (const param of params.split(';')) {
+        const [key, values] = param.split('=');
+        paramsObj[key] = values.split('|');
+      }
+    }
+    return new FcrPermission(module, action, paramsObj, roles ? roles.split('|') : []);
+  }
+}
+export const getLocalUserPermissionInfo = (scene, action) => {
+  const permissionStringArray = scene.getUserPropertiesByKeyPath(`permission.list`, scene.localUser.getLocalUserId());
+  const permissionString = permissionStringArray.find(permission => permission.startsWith(action));
+  if (!permissionString) {
+    return {
+      enable: false
+    };
+  }
+  return convertPermissionInfo(FcrPermission.fromString(permissionString), FcrOperatePermissionType.GET);
+};
+const convertPermissionInfo = (permission, operateType) => {
+  if (!permission) {
+    return {
+      enable: false
+    };
+  }
+  const {
+    module,
+    action
+  } = permission;
+  const permissionInfo = {
+    enable: operateType === FcrOperatePermissionType.ADD || operateType === FcrOperatePermissionType.GET ? true : false,
+    info: {
+      targetRoles: permission.targetRoles.map(role => convertStringPrivilegeRoleToFcrPrivilegeRole(role)),
+      action: `${module}:${action}`,
+      params: permission.conditions
+    }
+  };
+  return permissionInfo;
+};
+export const addLocalUserPermissionObserver = (scene, observer, cache) => {
+  scene.addObserver({
+    onUserPropertiesUpdated: (sceneId, event) => {
+      if (event.cause?.cmd === 3200) {
+        if (event.modifiedUser.userId === scene.localUser.getLocalUserId()) {
+          const data = event.cause.data;
+          const addedPermissions = data.addPermissions?.map(p => convertPermissionInfo(FcrPermission.fromString(p), FcrOperatePermissionType.ADD));
+          const removedPermissions = data.removePermissions?.map(p => convertPermissionInfo(FcrPermission.fromString(p), FcrOperatePermissionType.DELETE));
+          if (removedPermissions && removedPermissions.length > 0) {
+            observer.onLocalUserPermissionInfoDeleted && observer.onLocalUserPermissionInfoDeleted(sceneId, {
+              permissionInfo: removedPermissions,
+              operatorUser: checkFcrUserRole(convertRteUserToFcrUser(event.operatorUser, cache)),
+              cause: event.cause
+            });
+          }
+          if (addedPermissions && addedPermissions.length > 0) {
+            observer.onLocalUserPermissionInfoAdded && observer.onLocalUserPermissionInfoAdded(sceneId, {
+              permissionInfo: addedPermissions,
+              operatorUser: checkFcrUserRole(convertRteUserToFcrUser(event.operatorUser, cache)),
+              cause: event.cause
+            });
+          }
+        }
+      }
+    }
+  });
+};