fcr-core 3.8.1 → 3.9.0-alpha

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

@@ -0,0 +1,339 @@
+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, _allowWriteAnnotationDecs, _getSecurityInfoDecs, _getLocalUserPermissionInfoDecs, _enableLockedRoomDecs, _allowShareAndWriteDecs, _allowWriteBoardDecs, _allowWriteBoardByUserIdsDecs, _allowSendChatDecs, _allowStartAudioDecs, _allowStartVideoDecs, _allowJoinWithMutedAudioDecs, _allowJoinWithMutedVideoDecs, _allowWatermarkDecs, _allowChangeUserNameDecs, _allowStartCaptionDecs, _allowStartTranscribingDecs, _allowUpdateSttSourceLanguageDecs, _allowJoinWithPromptSoundDecs;
+import "core-js/modules/esnext.iterator.constructor.js";
+import "core-js/modules/esnext.iterator.for-each.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 { ErrorModuleCode } from '../../imports';
+import { AgoraObservable, get, trace } from '../../imports';
+import { booleanSchema, fcrLineTypeSchema, fcrPermissionActionSchema, fcrPrivilegeUserRoleArraySchema, fcrSecurityActionSchema, fcrSecuritySendChatPayloadSchema, stringArraySchema } from '../../schema';
+import { FcrLineType, FcrReturnCode } from '../../type';
+import { handleRequestError } from '../../utilities/error';
+import { createLogger, generateLogObserver } from '../../utilities/logger';
+import { checkFcrUserRole, convertRteUserToFcrUser, convertStringPrivilegeRoleToFcrPrivilegeRole } from '../../utilities/user';
+import validateParams from '../../utilities/validate-params';
+import { FcrPermission, addLocalUserPermissionObserver, getLocalUserPermissionInfo } from './helper';
+import { FcrOperatePermissionType, FcrPrivilegeUserRoleToStringMap, FcrSecurityAction } from './type';
+/**
+ * @internal
+ */
+export class FcrPrivilegeControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[_allowWriteAnnotationDecs, 2, "allowWriteAnnotation"], [_getSecurityInfoDecs, 2, "getSecurityInfo"], [_getLocalUserPermissionInfoDecs, 2, "getLocalUserPermissionInfo"], [_enableLockedRoomDecs, 2, "enableLockedRoom"], [_allowShareAndWriteDecs, 2, "allowShareAndWrite"], [_allowWriteBoardDecs, 2, "allowWriteBoard"], [_allowWriteBoardByUserIdsDecs, 2, "allowWriteBoardByUserIds"], [_allowSendChatDecs, 2, "allowSendChat"], [_allowStartAudioDecs, 2, "allowStartAudio"], [_allowStartVideoDecs, 2, "allowStartVideo"], [_allowJoinWithMutedAudioDecs, 2, "allowJoinWithMutedAudio"], [_allowJoinWithMutedVideoDecs, 2, "allowJoinWithMutedVideo"], [_allowWatermarkDecs, 2, "allowWatermark"], [_allowChangeUserNameDecs, 2, "allowChangeUserName"], [_allowStartCaptionDecs, 2, "allowStartCaption"], [_allowStartTranscribingDecs, 2, "allowStartTranscribing"], [_allowUpdateSttSourceLanguageDecs, 2, "allowUpdateSttSourceLanguage"], [_allowJoinWithPromptSoundDecs, 2, "allowJoinWithPromptSound"]], []).e;
+  }
+  //@internal
+  [(_allowWriteAnnotationDecs = trace(['enable', 'targetRoles']), _getSecurityInfoDecs = [trace(['action']), validateParams(fcrSecurityActionSchema)], _getLocalUserPermissionInfoDecs = [trace(['action']), validateParams(fcrPermissionActionSchema)], _enableLockedRoomDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowShareAndWriteDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardByUserIdsDecs = [trace(['enable', 'targetUserIds']), validateParams(booleanSchema, stringArraySchema)], _allowSendChatDecs = [trace(['enable', 'targetRoles', 'payload']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema, fcrSecuritySendChatPayloadSchema)], _allowStartAudioDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowStartVideoDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedAudioDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedVideoDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowWatermarkDecs = [trace(['enable', 'targetRoles', 'lineType']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema, fcrLineTypeSchema.optional())], _allowChangeUserNameDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowStartCaptionDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowStartTranscribingDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowUpdateSttSourceLanguageDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], _allowJoinWithPromptSoundDecs = [trace(['enable', 'targetRoles']), validateParams(booleanSchema, fcrPrivilegeUserRoleArraySchema)], "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrPrivilegeControlImpl'
+  }));
+  _observable = new AgoraObservable();
+  constructor(_engine, _scene, _api, _sharedCache) {
+    this._engine = _engine;
+    this._scene = _scene;
+    this._api = _api;
+    this._sharedCache = _sharedCache;
+    this._roomCache = _sharedCache.getRoomCache(this._scene.sceneId);
+    this._addLogObserver();
+    this._addSceneObserver();
+  }
+  async allowWriteAnnotation(enable, targetRoles) {
+    await handleRequestError(() => this._api.toggleAnnotation({
+      roomId: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      payload: {
+        write: enable ? 1 : 0
+      }
+    }), ErrorModuleCode.FCR_ROOM_WHITEBOARD, 'allow annotation failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  getSecurityInfo(action) {
+    const info = this._scene.getScenePropertiesByKeyPath(`security.${action}`);
+    return this._convertSecurityInfo(info, action);
+  }
+  // @trace
+  getAllSecurityInfo() {
+    const map = this._scene.getScenePropertiesByKeyPath('security');
+    const securityKeys = Object.keys(map);
+    return securityKeys.map(key => this._convertSecurityInfo(map[key], key));
+  }
+
+  /* getSecurityInfoByTargetRole(targetRole: FcrUserRole): FcrSecurityInfo[] {
+    const map = this._scene.getScenePropertiesByKeyPath('security') as Record<
+      string,
+      FcrSecurityObj
+    >;
+     const securityKeys = Object.keys(map);
+     const infoListOfTargetRole = securityKeys.filter((key) =>
+      map[key].targetRoles.includes(FcrUserRoleToStringMap[targetRole]),
+    );
+     return infoListOfTargetRole.map((key) => this._convertSecurityInfo(map[key], key));
+  } */
+
+  getLocalUserPermissionInfo(action) {
+    return getLocalUserPermissionInfo(this._scene, action);
+  }
+
+  // @trace
+  getAllLocalUserPermissionInfo() {
+    const permissionStringArray = this._scene.getUserPropertiesByKeyPath(`permission.list`, this._scene.localUser.getLocalUserId());
+    return permissionStringArray.map(permissionString => this._convertPermissionInfo(FcrPermission.fromString(permissionString), FcrOperatePermissionType.GET));
+  }
+  async enableLockedRoom(enable, targetRoles) {
+    return handleRequestError(() => this._api.enableLockedRoom({
+      enable,
+      roomId: this._scene.sceneId,
+      targetRoles
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'enable locked room failed');
+  }
+  async allowShareAndWrite(enable, targetRoles) {
+    await handleRequestError(() => this._api.toggleShareEnable({
+      roomId: this._scene.sceneId,
+      enable: true,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      payload: {
+        screen: enable ? 1 : 0,
+        board: {
+          start: enable ? 1 : 0
+        },
+        annotation: {
+          start: enable ? 1 : 0
+        }
+      }
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow share failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowWriteBoard(enable, targetRoles) {
+    await handleRequestError(() => this._api.toggleShareEnable({
+      roomId: this._scene.sceneId,
+      enable: true,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      payload: {
+        // screen: 1,
+        board: {
+          write: enable ? 1 : 0
+        },
+        annotation: {
+          write: enable ? 1 : 0
+        }
+      }
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow write board failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowWriteBoardByUserIds(enable, targetUserIds) {
+    await handleRequestError(() => this._api.toggleShareEnableByUserIds({
+      roomId: this._scene.sceneId,
+      enable: true,
+      toUserUuids: targetUserIds,
+      payload: {
+        board: {
+          write: enable ? 1 : 0
+        }
+      }
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow write board by user ids failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowSendChat(enable, targetRoles, payload) {
+    await handleRequestError(() => this._api.allowSendChat({
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId,
+      payload
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow send chat failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowStartAudio(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowStartAudio({
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow start audio failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowStartVideo(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowStartVideo({
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow start video failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowJoinWithMutedAudio(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowJoinWithMuteAudio({
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow join with mute audio failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowJoinWithMutedVideo(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowJoinWithMutedVideo({
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow join with mute audio failed');
+    return FcrReturnCode.SUCCESS;
+  }
+
+  /* async allowChangeName(enable: boolean, targetRoles: FcrPrivilegeUserRole[]) {
+    await this._api.allowChangeName({
+      enable,
+      targetRoles: targetRoles.map((role) => FcrPrivilegeUserRoleToStringMap[role]),
+      roomId: this._scene.sceneId,
+    });
+  } */
+
+  /** 开启水印 */
+  async allowWatermark(enable, targetRoles, lineType) {
+    await handleRequestError(() => this._api.allowWatermark({
+      roomId: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
+      payload: {
+        lineType: lineType ?? FcrLineType.SINGLE_ROW
+      }
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow water mark failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowChangeUserName(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowChangeUserName({
+      roomId: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role])
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow change user name failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowStartCaption(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowStartCaption({
+      roomUuid: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role])
+    }), ErrorModuleCode.FCR_ROOM_STT, 'allow start caption failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowStartTranscribing(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowStartTranscribing({
+      roomUuid: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role])
+    }), ErrorModuleCode.FCR_ROOM_STT, 'allow start transcribing failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowUpdateSttSourceLanguage(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowUpdateSttSourceLanguage({
+      roomUuid: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role])
+    }), ErrorModuleCode.FCR_ROOM_STT, 'allow update stt source language failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowJoinWithPromptSound(enable, targetRoles) {
+    await handleRequestError(() => this._api.allowJoinWithPromptSound({
+      roomId: this._scene.sceneId,
+      enable,
+      targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role])
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow join with prompt sound failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  addObserver(observer) {
+    this._observable.addObserver(observer);
+  }
+  removeObserver(observer) {
+    this._observable.removeObserver(observer);
+  }
+  _convertSecurityInfo(security, action) {
+    if (!security) {
+      return {
+        enable: false
+      };
+    }
+    const {
+      targetRoles,
+      payload
+    } = security;
+    if (action === FcrSecurityAction.Annotation) {
+      return {
+        info: {
+          action: action,
+          payload
+        },
+        ...security
+      };
+    }
+    return {
+      enable: !!security.enable,
+      info: {
+        targetRoles: targetRoles ? targetRoles.map(role => convertStringPrivilegeRoleToFcrPrivilegeRole(role)) : [],
+        payload,
+        action: action
+      }
+    };
+  }
+  _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;
+  }
+  _addSceneObserver() {
+    this._scene.addObserver({
+      onScenePropertiesUpdated: (sceneId, event) => {
+        if ('security' in event.changedProperties) {
+          const securityChangedKeys = Object.keys(event.changedProperties.security);
+          securityChangedKeys.forEach(key => {
+            const infoObj = get(event.changedProperties, `security.${key}`);
+            this._observable.notifyObservers('onSecurityInfoUpdated', sceneId, {
+              securityInfo: this._convertSecurityInfo(infoObj, key),
+              operatorUser: checkFcrUserRole(convertRteUserToFcrUser(event.operatorUser, this._roomCache)),
+              cause: event.cause
+            });
+          });
+        }
+      }
+    });
+    addLocalUserPermissionObserver(this._scene, {
+      onLocalUserPermissionInfoAdded: (sceneId, event) => {
+        this._observable.notifyObservers('onLocalUserPermissionInfoAdded', sceneId, event);
+      },
+      onLocalUserPermissionInfoDeleted: (sceneId, event) => {
+        this._observable.notifyObservers('onLocalUserPermissionInfoDeleted', sceneId, event);
+      }
+    }, this._roomCache);
+  }
+  _addLogObserver() {
+    this.addObserver(generateLogObserver(this.logger, [['onSecurityInfoUpdated', ['roomId', 'event']], ['onLocalUserPermissionInfoAdded', ['roomId', 'event']], ['onLocalUserPermissionInfoDeleted', ['roomId', 'event']]]));
+  }
+}

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

@@ -0,0 +1,159 @@
+// privilege control
+export let FcrPrivilegeUserRole = /*#__PURE__*/function (FcrPrivilegeUserRole) {
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["HOST"] = 1] = "HOST";
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["COHOST"] = 2] = "COHOST";
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["PARTICIPANT"] = 3] = "PARTICIPANT";
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["AUDIENCE"] = 4] = "AUDIENCE";
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["OBSERVER"] = 5] = "OBSERVER";
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["ROBOT"] = 6] = "ROBOT";
+  // All,
+  FcrPrivilegeUserRole[FcrPrivilegeUserRole["SELF"] = 7] = "SELF";
+  return FcrPrivilegeUserRole;
+}({});
+export const FcrPrivilegeUserRoleToStringMap = {
+  [FcrPrivilegeUserRole.HOST]: 'host',
+  [FcrPrivilegeUserRole.COHOST]: 'cohost',
+  [FcrPrivilegeUserRole.PARTICIPANT]: 'participant',
+  [FcrPrivilegeUserRole.AUDIENCE]: 'audience',
+  [FcrPrivilegeUserRole.OBSERVER]: 'observer',
+  [FcrPrivilegeUserRole.ROBOT]: 'robot',
+  [FcrPrivilegeUserRole.SELF]: '~'
+};
+export const FcrPrivilegeUserStringToRoleMap = {
+  host: FcrPrivilegeUserRole.HOST,
+  cohost: FcrPrivilegeUserRole.COHOST,
+  participant: FcrPrivilegeUserRole.PARTICIPANT,
+  audience: FcrPrivilegeUserRole.AUDIENCE,
+  observer: FcrPrivilegeUserRole.OBSERVER,
+  robot: FcrPrivilegeUserRole.ROBOT,
+  '~': FcrPrivilegeUserRole.SELF
+};
+
+//结构{module}:{action}-{k1=v1|v2;k2=v3}>{role1|role2},获取{module}:{action}
+export let FcrPermissionAction = /*#__PURE__*/function (FcrPermissionAction) {
+  FcrPermissionAction["RoomStart"] = "room:start";
+  FcrPermissionAction["RoomEnd"] = "room:end";
+  FcrPermissionAction["RoomSetPassword"] = "room:setPassword";
+  FcrPermissionAction["RoomJoin"] = "room:join";
+  FcrPermissionAction["RoomLeave"] = "room:leave";
+  FcrPermissionAction["RoomLock"] = "room:lock";
+  FcrPermissionAction["RoomUnlock"] = "room:unlock";
+  FcrPermissionAction["RoomEnableWatermark"] = "room:enableWatermark";
+  FcrPermissionAction["RoomDisableWatermark"] = "room:disableWatermark";
+  FcrPermissionAction["UserSetRole"] = "user:setRole";
+  FcrPermissionAction["UserKickOut"] = "user:kickOut";
+  FcrPermissionAction["UserBlock"] = "user:block";
+  FcrPermissionAction["UserChangeName"] = "user:changeName";
+  FcrPermissionAction["UserEnableChangeName"] = "user:enableChangeName";
+  FcrPermissionAction["UserDisableChangeName"] = "user:disableChangeName";
+  FcrPermissionAction["UserRevokeRole"] = "user:revokeRole";
+  FcrPermissionAction["UserAllowChangeName"] = "user:allowChangeName";
+  FcrPermissionAction["UserDisallowChangeName"] = "user:disallowChangeName";
+  FcrPermissionAction["StreamMuteAudio"] = "stream:muteAudio";
+  FcrPermissionAction["StreamStartAudio"] = "stream:startAudio";
+  FcrPermissionAction["StreamRequestStartAudio"] = "stream:requestStartAudio";
+  FcrPermissionAction["StreamEnableStartAudio"] = "stream:allowStartAudio";
+  FcrPermissionAction["StreamDisableStartAudio"] = "stream:disallowStartAudio";
+  FcrPermissionAction["StreamStopVideo"] = "stream:stopVideo";
+  FcrPermissionAction["StreamStartVideo"] = "stream:startVideo";
+  FcrPermissionAction["StreamRequestStartVideo"] = "stream:requestStartVideo";
+  FcrPermissionAction["StreamEnableStartVideo"] = "stream:allowStartVideo";
+  FcrPermissionAction["StreamDisableStartVideo"] = "stream:disallowStartVideo";
+  FcrPermissionAction["StreamStartScreenShare"] = "stream:startScreenSharing";
+  FcrPermissionAction["StreamStopScreenShare"] = "stream:stopScreenSharing";
+  FcrPermissionAction["StreamEnableStartScreenShare"] = "stream:allowStartScreenSharing";
+  FcrPermissionAction["StreamDisableStartScreenShare"] = "stream:disallowStartScreenSharing";
+  FcrPermissionAction["StreamBatchMuteAudio"] = "stream:batchMuteAudio";
+  FcrPermissionAction["StreamBatchRequestStartAudio"] = "stream:batchRequestStartAudio";
+  FcrPermissionAction["StreamDisableJoinWithVideo"] = "stream:allowJoinWithCloseVideo";
+  FcrPermissionAction["StreamEnableJoinWithVideo"] = "stream:disallowJoinWithCloseVideo";
+  FcrPermissionAction["StreamDisableJoinWithAudio"] = "stream:allowJoinWithMuteAudio";
+  FcrPermissionAction["StreamEnableJoinWithAudio"] = "stream:disallowJoinWithMuteAudio";
+  FcrPermissionAction["StreamAllowJoinWithPromptSound"] = "stream:allowJoinWithPromptSound";
+  FcrPermissionAction["WaitingRoomOpen"] = "waitingRoom:enable";
+  FcrPermissionAction["WaitingRoomClose"] = "waitingRoom:disable";
+  FcrPermissionAction["WaitingRoomAddUser"] = "waitingRoom:addUser";
+  FcrPermissionAction["WaitingRoomRemoveUser"] = "waitingRoom:removeUser";
+  FcrPermissionAction["ChatSendPublic"] = "chat:sendPublic";
+  FcrPermissionAction["ChatSendPrivate"] = "chat:sendPrivate";
+  FcrPermissionAction["ChatAllowSendPublic"] = "chat:allowSendPublic";
+  FcrPermissionAction["ChatDisallowSendPublic"] = "chat:disallowSendPublic";
+  FcrPermissionAction["ChatAllowSendPrivate"] = "chat:allowSendPrivate";
+  FcrPermissionAction["ChatDisallowSendPrivate"] = "chat:disallowSendPrivate";
+  FcrPermissionAction["LiveStart"] = "live:start";
+  FcrPermissionAction["LiveStop"] = "live:stop";
+  FcrPermissionAction["LiveGetLink"] = "live:getLink";
+  FcrPermissionAction["RecordStartCloudRecording"] = "record:startCloudRecording";
+  FcrPermissionAction["RecordStopCloudRecording"] = "record:stopCloudRecording";
+  FcrPermissionAction["RecordPauseCloudRecording"] = "record:pauseCloudRecording";
+  FcrPermissionAction["RecordResumeCloudRecording"] = "record:resumeCloudRecording";
+  FcrPermissionAction["CallCallIn"] = "call:callIn";
+  FcrPermissionAction["CallHangUp"] = "call:hangUp";
+  FcrPermissionAction["CallInvite"] = "call:invite";
+  FcrPermissionAction["CallMerge"] = "call:merge";
+  FcrPermissionAction["CallSplit"] = "call:split";
+  FcrPermissionAction["BoardStart"] = "board:start";
+  FcrPermissionAction["BoardClose"] = "board:close";
+  FcrPermissionAction["BoardWrite"] = "board:write";
+  FcrPermissionAction["BoardAllowStart"] = "board:allowStart";
+  FcrPermissionAction["BoardDisallowStart"] = "board:disallowStart";
+  FcrPermissionAction["BoardAllowWrite"] = "board:allowWrite";
+  FcrPermissionAction["BoardDisallowWrite"] = "board:disallowWrite";
+  FcrPermissionAction["InterpreterStart"] = "interpreter:start";
+  FcrPermissionAction["InterpreterStop"] = "interpreter:stop";
+  FcrPermissionAction["AnnotationStart"] = "annotation:start";
+  FcrPermissionAction["AnnotationWrite"] = "annotation:write";
+  FcrPermissionAction["AnnotationAllowWrite"] = "annotation:allowWrite";
+  FcrPermissionAction["SttAllowStartCaption"] = "stt:allowStartCaption";
+  FcrPermissionAction["SttDisallowStartCaption"] = "stt:disallowStartCaption";
+  FcrPermissionAction["SttAllowStartTranscribe"] = "stt:allowStartTranscribe";
+  FcrPermissionAction["SttDisallowStartTranscribe"] = "stt:disallowStartTranscribe";
+  FcrPermissionAction["SttAllowModifySpeechLanguage"] = "stt:allowModifySpeechLanguage";
+  FcrPermissionAction["SttDisallowModifySpeechLanguage"] = "stt:disallowModifySpeechLanguage";
+  FcrPermissionAction["SttStartCaption"] = "stt:startCaption";
+  FcrPermissionAction["SttStopCaption"] = "stt:stopCaption";
+  FcrPermissionAction["SttStartTranscribe"] = "stt:startTranscribe";
+  FcrPermissionAction["SttStopTranscribe"] = "stt:stopTranscribe";
+  FcrPermissionAction["SttModifySpeechLanguage"] = "stt:modifySpeechLanguage";
+  return FcrPermissionAction;
+}({});
+export let FcrOperatePermissionType = /*#__PURE__*/function (FcrOperatePermissionType) {
+  FcrOperatePermissionType[FcrOperatePermissionType["GET"] = 0] = "GET";
+  FcrOperatePermissionType[FcrOperatePermissionType["ADD"] = 1] = "ADD";
+  FcrOperatePermissionType[FcrOperatePermissionType["DELETE"] = 2] = "DELETE";
+  return FcrOperatePermissionType;
+}({});
+export let FcrChatPermissionType = /*#__PURE__*/function (FcrChatPermissionType) {
+  FcrChatPermissionType[FcrChatPermissionType["DISABLE_ALL_CHAT"] = 0] = "DISABLE_ALL_CHAT";
+  FcrChatPermissionType[FcrChatPermissionType["ENABLE_ALL_CHAT"] = 1] = "ENABLE_ALL_CHAT";
+  FcrChatPermissionType[FcrChatPermissionType["DISABLE_PRIVATE_CHAT"] = 2] = "DISABLE_PRIVATE_CHAT";
+  FcrChatPermissionType[FcrChatPermissionType["ENABLE_PRIVATE_CHAT_TO_HOST"] = 3] = "ENABLE_PRIVATE_CHAT_TO_HOST";
+  return FcrChatPermissionType;
+}({});
+export let FcrSecurityAction = /*#__PURE__*/function (FcrSecurityAction) {
+  FcrSecurityAction["ChangeName"] = "changeName";
+  FcrSecurityAction["SendChat"] = "sendChat";
+  FcrSecurityAction["JoinWithMuteAudio"] = "joinWithMuteAudio";
+  FcrSecurityAction["JoinWithCloseVideo"] = "joinWithCloseVideo";
+  FcrSecurityAction["LockedRoom"] = "lockedRoom";
+  FcrSecurityAction["Password"] = "password";
+  FcrSecurityAction["StartVideo"] = "startVideo";
+  FcrSecurityAction["StartAudio"] = "startAudio";
+  FcrSecurityAction["ShareScreen"] = "shareScreen";
+  FcrSecurityAction["WaitingRoom"] = "waitingRoom";
+  FcrSecurityAction["ShareBoard"] = "shareBoard";
+  FcrSecurityAction["BoardAllowWrite"] = "boardAllowWrite";
+  FcrSecurityAction["Sharing"] = "sharing";
+  FcrSecurityAction["WaterMark"] = "watermark";
+  FcrSecurityAction["Annotation"] = "annotation";
+  FcrSecurityAction["SttSourceLanguage"] = "stt";
+  FcrSecurityAction["SttStartCaption"] = "caption";
+  FcrSecurityAction["SttStartTranscribe"] = "transcribe";
+  FcrSecurityAction["JoinWithPromptSound"] = "joinWithPromptSound";
+  return FcrSecurityAction;
+}({});
+export let FcrWatermarkPermissionState = /*#__PURE__*/function (FcrWatermarkPermissionState) {
+  FcrWatermarkPermissionState[FcrWatermarkPermissionState["ON"] = 1] = "ON";
+  FcrWatermarkPermissionState[FcrWatermarkPermissionState["OFF"] = 0] = "OFF";
+  return FcrWatermarkPermissionState;
+}({});