fcr-core 3.10.2 → 3.10.5

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

@@ -1,3 +1,5 @@
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.error.cause.js";
 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";
@@ -15,7 +17,11 @@ 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/web.dom-collections.iterator.js";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _FcrMainRoomControlImpl;
+let _initProto, _enableWaitingRoomDecs, _moveToWaitingRoomByUserIdsDecs, _ref;
 import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.json.stringify.js";
 import "core-js/modules/esnext.iterator.constructor.js";
@@ -39,32 +45,28 @@ import { FcrRoomType } from '../type';
 import { getAnnotationConfigFromRoomProperties } from '../whiteboard-control-v2/utils';
 import { hasAnnotationWritePermission, hasBoardWritePermission } from '../whiteboard-control/utils';
 import { addBoardInitInfoObserver } from '../helpers/board-init-info-helper';
-const {
-  shared: sharedScheduler,
-  Duration
-} = AgoraScheduler;
+const sharedScheduler = AgoraScheduler.shared,
+  Duration = AgoraScheduler.Duration;
 /**
  * @internal
  */
+_ref = (_enableWaitingRoomDecs = [trace(['enable']), validateParams(booleanSchema)], _moveToWaitingRoomByUserIdsDecs = [trace(['userIds']), validateParams(stringArraySchema)], "logger");
 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, "_onLocalUserPermissionInfoDeleted"]], [], 0, void 0, FcrBaseRoomControlImpl).e;
-  }
-  //@internal
-  [(_enableWaitingRoomDecs = [trace(['enable']), validateParams(booleanSchema)], _moveToWaitingRoomByUserIdsDecs = [trace(['userIds']), validateParams(stringArraySchema)], "logger")] = (_initProto(this), createLogger({
-    prefix: 'FcrMainRoomControlImpl'
-  }));
-  _privilegeObserver = {
-    onLocalUserPermissionInfoDeleted: this._onLocalUserPermissionInfoDeleted
-  };
   constructor(engine, scene, api, config, sharedCache, chatConnection, chatRoomControl, monitorControl) {
     super(engine, scene, api, config, FcrRoomType.Mainroom, chatConnection, sharedCache, chatRoomControl);
+    //@internal
+    _defineProperty(this, _ref, (_initProto(this), createLogger({
+      prefix: 'FcrMainRoomControlImpl'
+    })));
+    _defineProperty(this, "_privilegeObserver", {
+      onLocalUserPermissionInfoDeleted: this._onLocalUserPermissionInfoDeleted
+    });
     this._monitorControl = monitorControl;
     this._groupControl = new FcrGroupControl(engine, scene, api, sharedCache);
     this._interpreterControl = new FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
     this._addLogObserver();
     addBoardInitInfoObserver(this._scene, this._api, this.logger);
-    this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
+    this.logger.info("initialized, room id: ".concat(this._scene.sceneId));
   }
 
   // @trace
@@ -98,7 +100,8 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
       privilegeControl.removeObserver(this._privilegeObserver);
       return await super.leave();
     } finally {
-      this._logUploadTask?.stop();
+      var _this$_logUploadTask;
+      (_this$_logUploadTask = this._logUploadTask) === null || _this$_logUploadTask === void 0 || _this$_logUploadTask.stop();
       this._uploadLog();
     }
   }
@@ -115,11 +118,14 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
     }), ErrorModuleCode.FCR_ROOM, 'enable waiting room failed');
   }
   async moveToWaitingRoomByUserIds(userIds) {
-    const [error] = await to(this._api.moveToWaitingRoomByUserIds(userIds, this._scene.sceneId));
+    const _await$to = await to(this._api.moveToWaitingRoomByUserIds(userIds, this._scene.sceneId)),
+      _await$to2 = _slicedToArray(_await$to, 1),
+      error = _await$to2[0];
     if (error) {
-      this.logger.error(`[RoomControl] move to waiting room failed, ${error.message}-${JSON.stringify(error)}`);
+      this.logger.error("[RoomControl] move to waiting room failed, ".concat(error.message, "-").concat(JSON.stringify(error)));
       if (error instanceof AgoraRestfulClientError) {
-        throw generateFcrCoreServerError(error.serviceCode ?? -1, error.message);
+        var _error$serviceCode;
+        throw generateFcrCoreServerError((_error$serviceCode = error.serviceCode) !== null && _error$serviceCode !== void 0 ? _error$serviceCode : -1, error.message);
       }
       throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, 'move to waiting room failed', error.message);
     }
@@ -130,12 +136,12 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
   }
   _onLocalUserPermissionInfoDeleted(roomId, event) {
     if (hasBoardWritePermission(event.permissionInfo)) {
-      this.logger.info(`remove board write permission`);
+      this.logger.info("remove board write permission");
 
       // this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
     }
     if (hasAnnotationWritePermission(event.permissionInfo)) {
-      this.logger.info(`remove annotation write permission`);
+      this.logger.info("remove annotation write permission");
 
       // this.getSharingControl().getAnnotationControl().getMainWindow()?.setWritable(false);
     }
@@ -149,12 +155,13 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
       const stream = streamControl.getStreamList().find(stream => stream.videoSourceType === FcrVideoSourceType.SCREEN);
       const localUserId = userControl.getLocalUser().userId;
       if (stream) {
+        var _userControl$getUser;
         const ownerId = stream.owner.userId;
         const isNotMeSharing = ownerId !== localUserId;
-        const platform = userControl.getUser(ownerId)?.platform;
+        const platform = (_userControl$getUser = userControl.getUser(ownerId)) === null || _userControl$getUser === void 0 ? void 0 : _userControl$getUser.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}`);
+        this.logger.info("check if set auto cancel draw, isPcPlatform: ".concat(isPcPlatform, ", isAndroidPlatform: ").concat(isAndroidPlatform, ", isNotMeSharing: ").concat(isNotMeSharing, ", ownerId: ").concat(ownerId, ", localUserId: ").concat(localUserId, ", platform: ").concat(platform));
         if (isPcPlatform) {
           mainWindow.setAutoCancelDraw(false);
         }
@@ -188,4 +195,9 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
     // 'onNetworkStatsUpdated',
     ['onRoomMessageReceived', ['roomId', 'message']], ['onRoomPropertiesDeleted', ['roomId', 'event']], ['onRoomPropertiesUpdated', ['roomId', 'event']], ['onRoomStateUpdated', ['roomId', 'state']]]));
   }
-}
+}
+_FcrMainRoomControlImpl = FcrMainRoomControlImpl;
+var _applyDecs$e = _applyDecs(_FcrMainRoomControlImpl, [[trace, 2, "join"], [trace, 2, "leave"], [_enableWaitingRoomDecs, 2, "enableWaitingRoom"], [_moveToWaitingRoomByUserIdsDecs, 2, "moveToWaitingRoomByUserIds"], [trace, 2, "moveToWaitingRoomByUserRoles"], [bound, 2, "_onLocalUserPermissionInfoDeleted"]], [], 0, void 0, FcrBaseRoomControlImpl).e;
+var _applyDecs$e2 = _slicedToArray(_applyDecs$e, 1);
+_initProto = _applyDecs$e2[0];
+_applyDecs$e;

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

@@ -1,6 +1,8 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.find.js";
 import "core-js/modules/esnext.iterator.map.js";
+import "core-js/modules/web.dom-collections.iterator.js";
 // 初始化权限策略表达式：{module}:{action}-{k1=v1|v2;k2=v3}>{role1|role2}
 // {module}表示模块，如房间模块room、用户模块user、发流模块stream等。
 // {action}表示操作，如结束房间、静音、开启视频等。
@@ -25,13 +27,25 @@ export class FcrPermission {
     this.targetRoles = targetRoles;
   }
   static fromString(permission) {
-    const [moduleActionParams, roles] = permission.split('>');
-    const [moduleAction, params] = moduleActionParams.split('-');
-    const [module, action] = moduleAction.split(':');
+    const _permission$split = permission.split('>'),
+      _permission$split2 = _slicedToArray(_permission$split, 2),
+      moduleActionParams = _permission$split2[0],
+      roles = _permission$split2[1];
+    const _moduleActionParams$s = moduleActionParams.split('-'),
+      _moduleActionParams$s2 = _slicedToArray(_moduleActionParams$s, 2),
+      moduleAction = _moduleActionParams$s2[0],
+      params = _moduleActionParams$s2[1];
+    const _moduleAction$split = moduleAction.split(':'),
+      _moduleAction$split2 = _slicedToArray(_moduleAction$split, 2),
+      module = _moduleAction$split2[0],
+      action = _moduleAction$split2[1];
     const paramsObj = {};
     if (params) {
       for (const param of params.split(';')) {
-        const [key, values] = param.split('=');
+        const _param$split = param.split('='),
+          _param$split2 = _slicedToArray(_param$split, 2),
+          key = _param$split2[0],
+          values = _param$split2[1];
         paramsObj[key] = values.split('|');
       }
     }
@@ -39,7 +53,7 @@ export class FcrPermission {
   }
 }
 export const getLocalUserPermissionInfo = (scene, action) => {
-  const permissionStringArray = scene.getUserPropertiesByKeyPath(`permission.list`, scene.localUser.getLocalUserId());
+  const permissionStringArray = scene.getUserPropertiesByKeyPath("permission.list", scene.localUser.getLocalUserId());
   const permissionString = permissionStringArray.find(permission => permission.startsWith(action));
   if (!permissionString) {
     return {
@@ -54,15 +68,13 @@ const convertPermissionInfo = (permission, operateType) => {
       enable: false
     };
   }
-  const {
-    module,
-    action
-  } = permission;
+  const module = permission.module,
+    action = permission.action;
   const permissionInfo = {
     enable: operateType === FcrOperatePermissionType.ADD || operateType === FcrOperatePermissionType.GET ? true : false,
     info: {
       targetRoles: permission.targetRoles.map(role => convertStringPrivilegeRoleToFcrPrivilegeRole(role)),
-      action: `${module}:${action}`,
+      action: "".concat(module, ":").concat(action),
       params: permission.conditions
     }
   };
@@ -71,11 +83,13 @@ const convertPermissionInfo = (permission, operateType) => {
 export const addLocalUserPermissionObserver = (scene, observer, cache) => {
   scene.addObserver({
     onUserPropertiesUpdated: (sceneId, event) => {
-      if (event.cause?.cmd === 3200) {
+      var _event$cause;
+      if (((_event$cause = event.cause) === null || _event$cause === void 0 ? void 0 : _event$cause.cmd) === 3200) {
         if (event.modifiedUser.userId === scene.localUser.getLocalUserId()) {
+          var _data$addPermissions, _data$removePermissio;
           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));
+          const addedPermissions = (_data$addPermissions = data.addPermissions) === null || _data$addPermissions === void 0 ? void 0 : _data$addPermissions.map(p => convertPermissionInfo(FcrPermission.fromString(p), FcrOperatePermissionType.ADD));
+          const removedPermissions = (_data$removePermissio = data.removePermissions) === null || _data$removePermissio === void 0 ? void 0 : _data$removePermissio.map(p => convertPermissionInfo(FcrPermission.fromString(p), FcrOperatePermissionType.DELETE));
           if (removedPermissions && removedPermissions.length > 0) {
             observer.onLocalUserPermissionInfoDeleted && observer.onLocalUserPermissionInfoDeleted(sceneId, {
               permissionInfo: removedPermissions,

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

@@ -1,5 +1,8 @@
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.error.cause.js";
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.iterator.filter.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";
@@ -15,7 +18,13 @@ 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, _getRemoteUserPermissionEnableDecs, _allowViewUserCountDecs, _allowHandsUpDecs, _allowSendChatByUserRoleDecs, _allowSendChatByUserIdDecs;
+import "core-js/modules/web.dom-collections.iterator.js";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _FcrPrivilegeControlImpl;
+let _initProto, _allowWriteAnnotationDecs, _getSecurityInfoDecs, _getLocalUserPermissionInfoDecs, _enableLockedRoomDecs, _allowShareAndWriteDecs, _allowWriteBoardDecs, _allowWriteBoardByUserIdsDecs, _allowSendChatDecs, _allowStartAudioDecs, _allowStartVideoDecs, _allowJoinWithMutedAudioDecs, _allowJoinWithMutedVideoDecs, _allowWatermarkDecs, _allowChangeUserNameDecs, _allowStartCaptionDecs, _allowStartTranscribingDecs, _allowUpdateSttSourceLanguageDecs, _allowJoinWithPromptSoundDecs, _getRemoteUserPermissionEnableDecs, _allowViewUserCountDecs, _allowHandsUpDecs, _allowSendChatByUserRoleDecs, _allowSendChatByUserIdDecs, _ref;
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(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; }
 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";
@@ -37,16 +46,14 @@ import { FcrOperatePermissionType, FcrPrivilegeUserRoleToStringMap, FcrRemotePer
 /**
  * @internal
  */
+_ref = (_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)], _getRemoteUserPermissionEnableDecs = trace(['userId', 'type']), _allowViewUserCountDecs = trace(['enable', 'targetRoles']), _allowHandsUpDecs = trace(['enable', 'targetRoles']), _allowSendChatByUserRoleDecs = trace(['config', 'targetRoles']), _allowSendChatByUserIdDecs = trace(['enable', 'userId']), "logger");
 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"], [_getRemoteUserPermissionEnableDecs, 2, "getRemoteUserPermissionEnable"], [_allowViewUserCountDecs, 2, "allowViewUserCount"], [_allowHandsUpDecs, 2, "allowHandsUp"], [_allowSendChatByUserRoleDecs, 2, "allowSendChatByUserRole"], [_allowSendChatByUserIdDecs, 2, "allowSendChatByUserId"], [trace, 2, "release"]], []).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)], _getRemoteUserPermissionEnableDecs = trace(['userId', 'type']), _allowViewUserCountDecs = trace(['enable', 'targetRoles']), _allowHandsUpDecs = trace(['enable', 'targetRoles']), _allowSendChatByUserRoleDecs = trace(['config', 'targetRoles']), _allowSendChatByUserIdDecs = trace(['enable', 'userId']), "logger")] = (_initProto(this), createLogger({
-    prefix: 'FcrPrivilegeControlImpl'
-  }));
-  _observable = new AgoraObservable();
   constructor(_engine, _scene, _api, _sharedCache) {
+    //@internal
+    _defineProperty(this, _ref, (_initProto(this), createLogger({
+      prefix: 'FcrPrivilegeControlImpl'
+    })));
+    _defineProperty(this, "_observable", new AgoraObservable());
     this._engine = _engine;
     this._scene = _scene;
     this._api = _api;
@@ -67,7 +74,7 @@ export class FcrPrivilegeControlImpl {
     return FcrReturnCode.SUCCESS;
   }
   getSecurityInfo(action) {
-    const info = this._scene.getScenePropertiesByKeyPath(`security.${action}`);
+    const info = this._scene.getScenePropertiesByKeyPath("security.".concat(action));
     return this._convertSecurityInfo(info, action);
   }
   // @trace
@@ -95,7 +102,7 @@ export class FcrPrivilegeControlImpl {
 
   // @trace
   getAllLocalUserPermissionInfo() {
-    const permissionStringArray = this._scene.getUserPropertiesByKeyPath(`permission.list`, this._scene.localUser.getLocalUserId());
+    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) {
@@ -209,7 +216,7 @@ export class FcrPrivilegeControlImpl {
       enable,
       targetRoles: targetRoles.map(role => FcrPrivilegeUserRoleToStringMap[role]),
       payload: {
-        lineType: lineType ?? FcrLineType.SINGLE_ROW
+        lineType: lineType !== null && lineType !== void 0 ? lineType : FcrLineType.SINGLE_ROW
       }
     }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow water mark failed');
     return FcrReturnCode.SUCCESS;
@@ -319,18 +326,15 @@ export class FcrPrivilegeControlImpl {
         enable: false
       };
     }
-    const {
-      targetRoles,
-      payload
-    } = security;
+    const targetRoles = security.targetRoles,
+      payload = security.payload;
     if (action === FcrSecurityAction.Annotation) {
-      return {
+      return _objectSpread({
         info: {
           action: action,
           payload
-        },
-        ...security
-      };
+        }
+      }, security);
     }
     return {
       enable: !!security.enable,
@@ -347,15 +351,13 @@ export class FcrPrivilegeControlImpl {
         enable: false
       };
     }
-    const {
-      module,
-      action
-    } = permission;
+    const module = permission.module,
+      action = permission.action;
     const permissionInfo = {
       enable: operateType === FcrOperatePermissionType.ADD || operateType === FcrOperatePermissionType.GET ? true : false,
       info: {
         targetRoles: permission.targetRoles.map(role => convertStringPrivilegeRoleToFcrPrivilegeRole(role)),
-        action: `${module}:${action}`,
+        action: "".concat(module, ":").concat(action),
         params: permission.conditions
       }
     };
@@ -367,7 +369,7 @@ export class FcrPrivilegeControlImpl {
         if ('security' in event.changedProperties) {
           const securityChangedKeys = Object.keys(event.changedProperties.security);
           securityChangedKeys.forEach(key => {
-            const infoObj = get(event.changedProperties, `security.${key}`);
+            const infoObj = get(event.changedProperties, "security.".concat(key));
             this._observable.notifyObservers('onSecurityInfoUpdated', sceneId, {
               securityInfo: this._convertSecurityInfo(infoObj, key),
               operatorUser: checkFcrUserRole(convertRteUserToFcrUser(event.operatorUser, this._roomCache)),
@@ -377,7 +379,8 @@ export class FcrPrivilegeControlImpl {
         }
       },
       onUserPropertiesUpdated: (sceneId, event) => {
-        if (event.cause?.cmd === 3190) {
+        var _event$cause;
+        if (((_event$cause = event.cause) === null || _event$cause === void 0 ? void 0 : _event$cause.cmd) === 3190) {
           const sendChatPublic = event.changedProperties['security.sendChat.public'];
           const sendChatPrivateHost = event.changedProperties['security.sendChat.private.host'];
           const sendChatPrivateCoHost = event.changedProperties['security.sendChat.private.cohost'];
@@ -416,4 +419,9 @@ export class FcrPrivilegeControlImpl {
   _addLogObserver() {
     this.addObserver(generateLogObserver(this.logger, [['onSecurityInfoUpdated', ['roomId', 'event']], ['onLocalUserPermissionInfoAdded', ['roomId', 'event']], ['onLocalUserPermissionInfoDeleted', ['roomId', 'event']]]));
   }
-}
+}
+_FcrPrivilegeControlImpl = FcrPrivilegeControlImpl;
+var _applyDecs$e = _applyDecs(_FcrPrivilegeControlImpl, [[_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"], [_getRemoteUserPermissionEnableDecs, 2, "getRemoteUserPermissionEnable"], [_allowViewUserCountDecs, 2, "allowViewUserCount"], [_allowHandsUpDecs, 2, "allowHandsUp"], [_allowSendChatByUserRoleDecs, 2, "allowSendChatByUserRole"], [_allowSendChatByUserIdDecs, 2, "allowSendChatByUserId"], [trace, 2, "release"]], []).e;
+var _applyDecs$e2 = _slicedToArray(_applyDecs$e, 1);
+_initProto = _applyDecs$e2[0];
+_applyDecs$e;

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

@@ -1,3 +1,5 @@
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.error.cause.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";
@@ -14,11 +16,15 @@ 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, _startSessionByPhoneDecs, _startSessionByIPDecs, _stopSessionDecs;
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _FcrRoomConnectorControlImpl;
+let _initProto, _startSessionByPhoneDecs, _startSessionByIPDecs, _stopSessionDecs, _ref;
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/esnext.iterator.constructor.js";
 import "core-js/modules/esnext.iterator.map.js";
 import "core-js/modules/esnext.iterator.reduce.js";
+import "core-js/modules/web.dom-collections.iterator.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); }
@@ -30,25 +36,22 @@ import { createLogger, generateLogObserver } from '../../utilities/logger';
 import { handleRequestError } from '../../utilities/error';
 import validateParams from '../../utilities/validate-params';
 import { fcrIPConnectorSessionParamsSchema, fcrPhoneConnectorSessionParamsSchema, stringSchema } from '../../schema';
-import { FcrReturnCode } from '../../type';
 import { ErrorModuleCode } from '../../imports';
 
 /**
  * @internal
  */
+_ref = (_startSessionByPhoneDecs = [trace(['params']), validateParams(fcrPhoneConnectorSessionParamsSchema)], _startSessionByIPDecs = [trace(['params']), validateParams(fcrIPConnectorSessionParamsSchema)], _stopSessionDecs = [trace(['sessionId']), validateParams(stringSchema)], "logger");
 export class FcrRoomConnectorControlImpl {
-  static {
-    [_initProto] = _applyDecs(this, [[trace, 2, "getRoomConnectorPhoneInfo"], [trace, 2, "getRoomConnectorIpInfo"], [_startSessionByPhoneDecs, 2, "startSessionByPhone"], [_startSessionByIPDecs, 2, "startSessionByIP"], [_stopSessionDecs, 2, "stopSession"], [trace, 2, "release"]], []).e;
-  }
-  //@internal
-  [(_startSessionByPhoneDecs = [trace(['params']), validateParams(fcrPhoneConnectorSessionParamsSchema)], _startSessionByIPDecs = [trace(['params']), validateParams(fcrIPConnectorSessionParamsSchema)], _stopSessionDecs = [trace(['sessionId']), validateParams(stringSchema)], "logger")] = (_initProto(this), createLogger({
-    prefix: 'FcrRoomConnectorControlImpl'
-  }));
-  _observable = new AgoraObservable();
-  _sceneObserver = {
-    onSceneMessageReceived: this._handleMessageReceived.bind(this)
-  };
   constructor(_scene, _engine, _api) {
+    //@internal
+    _defineProperty(this, _ref, (_initProto(this), createLogger({
+      prefix: 'FcrRoomConnectorControlImpl'
+    })));
+    _defineProperty(this, "_observable", new AgoraObservable());
+    _defineProperty(this, "_sceneObserver", {
+      onSceneMessageReceived: this._handleMessageReceived.bind(this)
+    });
     this._scene = _scene;
     this._engine = _engine;
     this._api = _api;
@@ -56,16 +59,16 @@ export class FcrRoomConnectorControlImpl {
     this._scene.addObserver(this._sceneObserver);
   }
   getRoomConnectorPhoneInfo() {
+    var _ref2;
     const mid = this._scene.getScenePropertiesByKeyPath('call.mid');
-    const callIn = this._scene.getScenePropertiesByKeyPath('call.callIn') ?? [];
+    const callIn = (_ref2 = this._scene.getScenePropertiesByKeyPath('call.callIn')) !== null && _ref2 !== void 0 ? _ref2 : [];
     const uid = this._scene.getUserPropertiesByKeyPath('call.uid', this._scene.getLocalUser().getLocalUserId());
     const regionMap = {
       cn: FcrRoomConnectorPhoneRegion.CN
     };
-    return Promise.resolve(callIn.map(({
-      callNumbers,
-      region
-    }) => {
+    return Promise.resolve(callIn.map(_ref3 => {
+      let callNumbers = _ref3.callNumbers,
+        region = _ref3.region;
       return {
         region: regionMap[region],
         phoneNumberList: callNumbers,
@@ -75,12 +78,12 @@ export class FcrRoomConnectorControlImpl {
     }));
   }
   getRoomConnectorIpInfo() {
+    var _ref4;
     const mid = this._scene.getScenePropertiesByKeyPath('call.mid');
-    const callIn = this._scene.getScenePropertiesByKeyPath('call.callIn') ?? [];
+    const callIn = (_ref4 = this._scene.getScenePropertiesByKeyPath('call.callIn')) !== null && _ref4 !== void 0 ? _ref4 : [];
     return Promise.resolve({
-      addressList: callIn.reduce((prev, {
-        ipAddresses
-      }) => {
+      addressList: callIn.reduce((prev, _ref5) => {
+        let ipAddresses = _ref5.ipAddresses;
         if (Array.isArray(ipAddresses)) {
           prev.push(...ipAddresses);
         }
@@ -94,15 +97,14 @@ export class FcrRoomConnectorControlImpl {
       [FcrPhoneConnectorSessionType.PSTN]: 'pstn',
       [FcrPhoneConnectorSessionType.VOLTE]: 'volte'
     }[params.type];
-    const {
-      data
-    } = await handleRequestError(() => this._api.callPstn({
-      roomId: this._scene.sceneId,
-      callNumber: params.phoneNumber,
-      userId: params.phoneUserId,
-      userName: params.userName,
-      callType
-    }), ErrorModuleCode.FCR_ROOM, 'start session by phone failed');
+    const _await$handleRequestE = await handleRequestError(() => this._api.callPstn({
+        roomId: this._scene.sceneId,
+        callNumber: params.phoneNumber,
+        userId: params.phoneUserId,
+        userName: params.userName,
+        callType
+      }), ErrorModuleCode.FCR_ROOM, 'start session by phone failed'),
+      data = _await$handleRequestE.data;
     return data.data.sessionUuid;
   }
   async startSessionByIP(params) {
@@ -110,13 +112,12 @@ export class FcrRoomConnectorControlImpl {
       [FcrIPConnectorSessionType.H323]: 'h323',
       [FcrIPConnectorSessionType.SIP]: 'sip'
     }[params.type];
-    const {
-      data
-    } = await handleRequestError(() => this._api.callIp({
-      roomId: this._scene.sceneId,
-      callType,
-      ipAddress: params.address
-    }), ErrorModuleCode.FCR_ROOM, 'start session by IP failed');
+    const _await$handleRequestE2 = await handleRequestError(() => this._api.callIp({
+        roomId: this._scene.sceneId,
+        callType,
+        ipAddress: params.address
+      }), ErrorModuleCode.FCR_ROOM, 'start session by IP failed'),
+      data = _await$handleRequestE2.data;
     return data.data.sessionUuid;
   }
   async stopSession(sessionId) {
@@ -125,7 +126,6 @@ export class FcrRoomConnectorControlImpl {
       callId: sessionId,
       userId: this._scene.getLocalUser().getLocalUserId()
     }), ErrorModuleCode.FCR_ROOM, 'stop session failed');
-    return FcrReturnCode.SUCCESS;
   }
   addObserver(observer) {
     this._observable.addObserver(observer);
@@ -140,15 +140,13 @@ export class FcrRoomConnectorControlImpl {
   _handleMessageReceived(sceneId, message) {
     const cmd = message.cmd;
     if (cmd === 2001 || cmd === 2002 || cmd === 2003) {
-      const {
-        sessionUuid,
-        payload: {
-          callNumber,
-          reason,
-          callType,
-          ipAddress
-        }
-      } = message.payload;
+      const _ref6 = message.payload,
+        sessionUuid = _ref6.sessionUuid,
+        _ref6$payload = _ref6.payload,
+        callNumber = _ref6$payload.callNumber,
+        reason = _ref6$payload.reason,
+        callType = _ref6$payload.callType,
+        ipAddress = _ref6$payload.ipAddress;
       const reasonMap = {
         1: FcrRoomConnectorSessionReason.ACCEPTED,
         2: FcrRoomConnectorSessionReason.CANCELED,
@@ -189,4 +187,9 @@ export class FcrRoomConnectorControlImpl {
   _addLogObserver() {
     this.addObserver(generateLogObserver(this.logger, [['onIPConnectorSessionStateUpdated', ['session', 'state', 'reason']], ['onPhoneConnectorSessionStateUpdated', ['session', 'state', 'reason']]]));
   }
-}
+}
+_FcrRoomConnectorControlImpl = FcrRoomConnectorControlImpl;
+var _applyDecs$e = _applyDecs(_FcrRoomConnectorControlImpl, [[trace, 2, "getRoomConnectorPhoneInfo"], [trace, 2, "getRoomConnectorIpInfo"], [_startSessionByPhoneDecs, 2, "startSessionByPhone"], [_startSessionByIPDecs, 2, "startSessionByIP"], [_stopSessionDecs, 2, "stopSession"], [trace, 2, "release"]], []).e;
+var _applyDecs$e2 = _slicedToArray(_applyDecs$e, 1);
+_initProto = _applyDecs$e2[0];
+_applyDecs$e;

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

@@ -39,23 +39,21 @@ export class RoomControlFactory {
    * @throws {FcrError} 当房间类型不支持时抛出错误
    */
   static create(params) {
-    const {
-      engine,
-      scene,
-      apiService,
-      config,
-      chatConnection,
-      sharedCache,
-      roomResponse,
-      monitorControl
-    } = params;
+    const engine = params.engine,
+      scene = params.scene,
+      apiService = params.apiService,
+      config = params.config,
+      chatConnection = params.chatConnection,
+      sharedCache = params.sharedCache,
+      roomResponse = params.roomResponse,
+      monitorControl = params.monitorControl;
     const roomType = convertServerRoomTypeToFcrRoomType(roomResponse.room.roomProperties.roomType);
     if (roomType === null) {
-      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, `Unsupported room types: ${roomResponse.room.roomProperties.roomType}`);
+      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, "Unsupported room types: ".concat(roomResponse.room.roomProperties.roomType));
     }
     const RoomControlImpl = ROOM_CONTROL_IMPLEMENTATIONS[roomType];
     if (!RoomControlImpl) {
-      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, `Unsupported room types: ${roomType}`);
+      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, "Unsupported room types: ".concat(roomType));
     }
 
     // 创建聊天室控制