fcr-core 3.10.2 → 3.11.0-rc.2

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

@@ -54,6 +54,7 @@ export class FcrInfinityRoomControlImpl extends FcrBaseRoomControlImpl {
     this._interpreterControl = new FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
     this._addLogObserver();
     addBoardInitInfoObserver(this._scene, this._api, this.logger);
+    this._registerClientRecordingObserver();
     this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
   }
   getAnnouncement() {
@@ -108,13 +109,11 @@ export class FcrInfinityRoomControlImpl extends FcrBaseRoomControlImpl {
   _onLocalUserPermissionInfoDeleted(roomId, event) {
     if (hasBoardWritePermission(event.permissionInfo)) {
       this.logger.info(`remove board write permission`);
-
-      // this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
     }
     if (hasAnnotationWritePermission(event.permissionInfo)) {
       this.logger.info(`remove annotation write permission`);
-
-      // this.getSharingControl().getAnnotationControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getAnnotationControl().getMainWindow()?.setWritable(false);
     }
   }
   _addLogObserver() {

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

@@ -64,6 +64,7 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
     this._interpreterControl = new FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
     this._addLogObserver();
     addBoardInitInfoObserver(this._scene, this._api, this.logger);
+    this._registerClientRecordingObserver();
     this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
   }
 
@@ -131,13 +132,11 @@ export class FcrMainRoomControlImpl extends FcrBaseRoomControlImpl {
   _onLocalUserPermissionInfoDeleted(roomId, event) {
     if (hasBoardWritePermission(event.permissionInfo)) {
       this.logger.info(`remove board write permission`);
-
-      // this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
     }
     if (hasAnnotationWritePermission(event.permissionInfo)) {
       this.logger.info(`remove annotation write permission`);
-
-      // this.getSharingControl().getAnnotationControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getAnnotationControl().getMainWindow()?.setWritable(false);
     }
   }
   _checkIfUpdateAnnotationMainWindow() {

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

@@ -15,7 +15,7 @@ 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;
+let _initProto, _allowWriteAnnotationDecs, _getSecurityInfoDecs, _getLocalUserPermissionInfoDecs, _enableLockedRoomDecs, _allowShareAndWriteDecs, _allowWriteBoardDecs, _allowWriteBoardByUserIdsDecs, _allowSendChatDecs, _allowStartAudioDecs, _allowStartVideoDecs, _allowJoinWithMutedAudioDecs, _allowJoinWithMutedVideoDecs, _allowWatermarkDecs, _allowChangeUserNameDecs, _allowStartCaptionDecs, _allowStartTranscribingDecs, _allowUpdateSttSourceLanguageDecs, _allowJoinWithPromptSoundDecs, _allowClientRecordingDecs, _allowClientRecordingByUserIdDecs, _getRemoteUserPermissionEnableDecs, _allowViewUserCountDecs, _allowHandsUpDecs, _allowSendChatByUserRoleDecs, _allowSendChatByUserIdDecs;
 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";
@@ -33,16 +33,16 @@ 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, FcrRemotePermissionType, FcrSecurityAction, FcrTargetUserTypeToStringMap } from './type';
+import { FcrClientRecordingPermissionType, FcrOperatePermissionType, FcrPrivilegeUserRole, FcrPrivilegeUserRoleToStringMap, FcrRemotePermissionType, FcrSecurityAction, FcrTargetUserTypeToStringMap } 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"], [_getRemoteUserPermissionEnableDecs, 2, "getRemoteUserPermissionEnable"], [_allowViewUserCountDecs, 2, "allowViewUserCount"], [_allowHandsUpDecs, 2, "allowHandsUp"], [_allowSendChatByUserRoleDecs, 2, "allowSendChatByUserRole"], [_allowSendChatByUserIdDecs, 2, "allowSendChatByUserId"], [trace, 2, "release"]], []).e;
+    [_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"], [_allowClientRecordingDecs, 2, "allowClientRecording"], [_allowClientRecordingByUserIdDecs, 2, "allowClientRecordingByUserId"], [_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({
+  [(_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)], _allowClientRecordingDecs = trace(['permissionType']), _allowClientRecordingByUserIdDecs = trace(['userId', 'enable']), _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();
@@ -254,6 +254,25 @@ export class FcrPrivilegeControlImpl {
     }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow join with prompt sound failed');
     return FcrReturnCode.SUCCESS;
   }
+  async allowClientRecording(permissionType) {
+    const enable = permissionType === FcrClientRecordingPermissionType.HostOnly ? 0 : 1;
+    const targetRoles = permissionType === FcrClientRecordingPermissionType.AllMembers ? [FcrPrivilegeUserRoleToStringMap[FcrPrivilegeUserRole.PARTICIPANT]] : undefined;
+    await handleRequestError(() => this._api.allowClientRecording({
+      roomId: this._scene.sceneId,
+      permissionType,
+      enable,
+      targetRoles
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow client recording failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async allowClientRecordingByUserId(userId, enable) {
+    await handleRequestError(() => this._api.allowClientRecordingByUserId({
+      roomId: this._scene.sceneId,
+      toUserUuids: [userId],
+      enable
+    }), ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow client recording by user id failed');
+    return FcrReturnCode.SUCCESS;
+  }
   getRemoteUserPermissionEnable(userId, type) {
     if (userId === this._scene.localUser.getLocalUserId()) {
       return false;

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

@@ -112,6 +112,9 @@ export let FcrPermissionAction = /*#__PURE__*/function (FcrPermissionAction) {
   FcrPermissionAction["RecordStopCloudRecording"] = "record:stopCloudRecording";
   FcrPermissionAction["RecordPauseCloudRecording"] = "record:pauseCloudRecording";
   FcrPermissionAction["RecordResumeCloudRecording"] = "record:resumeCloudRecording";
+  FcrPermissionAction["RecordStartClientRecording"] = "record:startClientRecording";
+  FcrPermissionAction["RecordStopClientRecording"] = "record:stopClientRecording";
+  FcrPermissionAction["RecordSetClientRecordingPermission"] = "record:setClientRecordingPermission";
   FcrPermissionAction["CallCallIn"] = "call:callIn";
   FcrPermissionAction["CallHangUp"] = "call:hangUp";
   FcrPermissionAction["CallInvite"] = "call:invite";
@@ -177,6 +180,7 @@ export let FcrSecurityAction = /*#__PURE__*/function (FcrSecurityAction) {
   FcrSecurityAction["SttStartCaption"] = "caption";
   FcrSecurityAction["SttStartTranscribe"] = "transcribe";
   FcrSecurityAction["JoinWithPromptSound"] = "joinWithPromptSound";
+  FcrSecurityAction["ClientRecording"] = "clientRecording";
   FcrSecurityAction["HandsUp"] = "handsUp";
   FcrSecurityAction["ViewUserCount"] = "viewUserCount";
   return FcrSecurityAction;
@@ -186,6 +190,12 @@ export let FcrWatermarkPermissionState = /*#__PURE__*/function (FcrWatermarkPerm
   FcrWatermarkPermissionState[FcrWatermarkPermissionState["OFF"] = 0] = "OFF";
   return FcrWatermarkPermissionState;
 }({});
+export let FcrClientRecordingPermissionType = /*#__PURE__*/function (FcrClientRecordingPermissionType) {
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["HostOnly"] = 1] = "HostOnly";
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["AllMembers"] = 2] = "AllMembers";
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["SpecifiedMembers"] = 3] = "SpecifiedMembers";
+  return FcrClientRecordingPermissionType;
+}({});
 export let FcrRemotePermissionType = /*#__PURE__*/function (FcrRemotePermissionType) {
   FcrRemotePermissionType[FcrRemotePermissionType["SendChatToAll"] = 1] = "SendChatToAll";
   FcrRemotePermissionType[FcrRemotePermissionType["SendChatToCoParticipant"] = 2] = "SendChatToCoParticipant";

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

@@ -36,6 +36,7 @@ import { createLogger, generateLogObserver } from '../../utilities/logger';
 import { handleRequestError } from '../../utilities/error';
 import validateParams from '../../utilities/validate-params';
 import { fcrUserKickedOutTypeSchema, fcrUserRolesSchema, stringKeyUnknownValueSchema, stringSchema, stringArraySchema, fcrUserRoleSchema, stringKeyNumberValueSchema } from '../../schema';
+import { ROOM_MESSAGE_COMMANDS } from '../helpers/constants';
 import { ErrorModuleCode } from '../../imports';
 
 /**
@@ -169,6 +170,29 @@ export class FcrUserControlImpl {
           });
         }
       }
+      if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.CLIENT_RECORDING_PERMISSION) {
+        const {
+          changedProperties,
+          modifiedUser
+        } = event;
+        const enable = get(changedProperties, 'security.clientRecording');
+        if (Object.keys(changedProperties).length > 0) {
+          this._observable.notifyObservers('onUserClientRecordingPermissionUpdated', modifiedUser.userId, !!enable);
+        }
+      }
+      if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.USER_WIDGET_PROPERTIES_UPDATE) {
+        const widgetCauseCmd = event.cause?.data?.widgetCause?.cmd;
+        if (widgetCauseCmd === ROOM_MESSAGE_COMMANDS.CLIENT_RECORDING_STATE) {
+          const {
+            changedProperties,
+            modifiedUser
+          } = event;
+          const enable = get(changedProperties, 'widgets.clientRecording.state');
+          if (Object.keys(changedProperties).length > 0) {
+            this._observable.notifyObservers('onUserClientRecordingStateUpdated', modifiedUser.userId, !!enable);
+          }
+        }
+      }
     },
     onUserPropertiesDeleted: (roomId, event) => {
       if (event.cause?.cmd === 8) {
@@ -259,6 +283,14 @@ export class FcrUserControlImpl {
     } = this.getLocalUser();
     return get(this._scene.getUserPropertiesByUserId(userId), 'security.watermark.content');
   }
+  getUserClientRecordingState(userId) {
+    const state = get(this._scene.getUserPropertiesByUserId(userId), 'widgets.clientRecording.state');
+    return Boolean(state);
+  }
+  getUserClientRecordingPermission(userId) {
+    const permission = get(this._scene.getUserPropertiesByUserId(userId), 'security.clientRecording');
+    return Boolean(permission);
+  }
   async fetchUserList(params) {
     return await this._scene.fetchUserList(params);
   }

package/lib-es/room-control/whiteboard-control-v2/base/index.js

@@ -173,8 +173,8 @@ export class FcrBaseWhiteboardControlImpl {
         boardAppId,
         boardId,
         boardRegion,
-        boardToken
-        // boardPerformance = false,
+        boardToken,
+        boardPerformance = false
       } = this.boardRoomConfig || {};
       if (!boardAppId) {
         throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM_WHITEBOARD, DetailErrorCode.UNDEFINED_ERROR, 'boardAppId is required');
@@ -246,8 +246,8 @@ export class FcrBaseWhiteboardControlImpl {
               region: endpoint ? 'private' : boardRegion,
               appIdentifier: boardAppId
             },
-            endpoint,
-            writable: true
+            writable: isNeedLaunch,
+            endpoint
             // verboseLog: true,
           };
           this.logger.info(`Room.joinRoom calling, params: ${jsonstring(joinRoomParams)}, timeout: ${WHITEBOARD_ROOM_JOIN_TIMEOUT}`);
@@ -293,14 +293,11 @@ export class FcrBaseWhiteboardControlImpl {
         this.whiteboard = whiteboard;
         this.boardView = boardView;
         this.boardRoom = boardRoom;
-
-        // if (isNeedLaunch) {
-        //   // 所有人开启白板时都默认没有开启写权限, 需要写权限的地方需要自己手动开启
-        //   boardView.internalSetWritable(false);
-        // }
-
-        // boardView.setPerformanceMode(boardPerformance);
-
+        if (isNeedLaunch) {
+          // 所有人开启白板时都默认没有开启写权限, 需要写权限的地方需要自己手动开启
+          boardView.internalSetWritable(false);
+        }
+        boardView.setPerformanceMode(boardPerformance);
         this.updateConnectionState(FcrConnectionState.CONNECTED);
         resolve(boardView);
         if (this._waitPromiseResolve) {

package/lib-es/room-control/whiteboard-control-v2/base/main-window.js

@@ -15,7 +15,7 @@ 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, _setBackgroundColorDecs, _setToolTypeDecs, _setStrokeWidthDecs, _setStrokeColorDecs, _setTextColorDecs, _setTextSizeDecs, _insertImageDecs, _setContainerSizeRatioDecs, _setBoardTransparentDecs, _updateWindowSizeDecs, _setAutoCancelDrawDecs, _handleApplicationLaunchDecs, _handleApplicationTerminalDecs, _enableAutoCancelDecs;
+let _initProto, _setPerformanceModeDecs, _setBackgroundColorDecs, _setToolTypeDecs, _setStrokeWidthDecs, _setStrokeColorDecs, _setTextColorDecs, _setTextSizeDecs, _insertImageDecs, _setContainerSizeRatioDecs, _setBoardTransparentDecs, _updateWindowSizeDecs, _setAutoCancelDrawDecs, _handleApplicationLaunchDecs, _handleApplicationTerminalDecs, _enableAutoCancelDecs;
 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); }
@@ -34,9 +34,9 @@ import { handleRequestError } from '../../../utilities/error';
 import { ErrorModuleCode } from '../../../imports';
 export class FcrBoardMainWindowImpl {
   static {
-    [_initProto] = _applyDecs(this, [[trace, 2, "addPage"], [trace, 2, "removePage"], [trace, 2, "undo"], [trace, 2, "redo"], [trace, 2, "clean"], [trace, 2, "getSnapshotImage"], [_setBackgroundColorDecs, 2, "setBackgroundColor"], [trace, 2, "getPageInfo"], [trace, 2, "prevPage"], [trace, 2, "nextPage"], [_setToolTypeDecs, 2, "setToolType"], [_setStrokeWidthDecs, 2, "setStrokeWidth"], [_setStrokeColorDecs, 2, "setStrokeColor"], [_setTextColorDecs, 2, "setTextColor"], [_setTextSizeDecs, 2, "setTextSize"], [_insertImageDecs, 2, "insertImage"], [trace, 2, "getContentView"], [_setContainerSizeRatioDecs, 2, "setContainerSizeRatio"], [_setBoardTransparentDecs, 2, "setBoardTransparent"], [_updateWindowSizeDecs, 2, "updateWindowSize"], [_setAutoCancelDrawDecs, 2, "setAutoCancelDraw"], [trace, 2, "getWritable"], [_handleApplicationLaunchDecs, 2, "_handleApplicationLaunch"], [_handleApplicationTerminalDecs, 2, "_handleApplicationTerminal"], [_enableAutoCancelDecs, 2, "_enableAutoCancel"]], []).e;
+    [_initProto] = _applyDecs(this, [[trace, 2, "addPage"], [trace, 2, "removePage"], [trace, 2, "undo"], [trace, 2, "redo"], [trace, 2, "clean"], [trace, 2, "getSnapshotImage"], [_setPerformanceModeDecs, 2, "setPerformanceMode"], [_setBackgroundColorDecs, 2, "setBackgroundColor"], [trace, 2, "getPageInfo"], [trace, 2, "prevPage"], [trace, 2, "nextPage"], [_setToolTypeDecs, 2, "setToolType"], [_setStrokeWidthDecs, 2, "setStrokeWidth"], [_setStrokeColorDecs, 2, "setStrokeColor"], [_setTextColorDecs, 2, "setTextColor"], [_setTextSizeDecs, 2, "setTextSize"], [_insertImageDecs, 2, "insertImage"], [trace, 2, "getContentView"], [_setContainerSizeRatioDecs, 2, "setContainerSizeRatio"], [_setBoardTransparentDecs, 2, "setBoardTransparent"], [_updateWindowSizeDecs, 2, "updateWindowSize"], [_setAutoCancelDrawDecs, 2, "setAutoCancelDraw"], [trace, 2, "getWritable"], [_handleApplicationLaunchDecs, 2, "_handleApplicationLaunch"], [_handleApplicationTerminalDecs, 2, "_handleApplicationTerminal"], [_enableAutoCancelDecs, 2, "_enableAutoCancel"]], []).e;
   }
-  [(_setBackgroundColorDecs = [trace(['color']), validateParams(stringSchema)], _setToolTypeDecs = [trace(['type']), validateParams(fcrBoardToolTypeSchema)], _setStrokeWidthDecs = [trace(['strokeWidth']), validateParams(numberSchema)], _setStrokeColorDecs = [trace(['color']), validateParams(z.union([colorSchema, stringSchema]))], _setTextColorDecs = [trace(['color']), validateParams(colorSchema)], _setTextSizeDecs = [trace(['textSize']), validateParams(numberSchema)], _insertImageDecs = [trace(['resourceUrl', 'x', 'y', 'width', 'height']), validateParams(stringSchema, numberSchema, numberSchema, numberSchema, numberSchema)], _setContainerSizeRatioDecs = [trace(['ratio']), validateParams(numberSchema)], _setBoardTransparentDecs = [trace(['isTransparent']), validateParams(booleanSchema)], _updateWindowSizeDecs = [trace(['size']), validateParams(fcrSizeSchema)], _setAutoCancelDrawDecs = [trace(['enable']), validateParams(booleanSchema)], _handleApplicationLaunchDecs = [bound, trace(['appId', 'app'])], _handleApplicationTerminalDecs = [bound, trace(['appId', 'app'])], _enableAutoCancelDecs = trace(['enable']), "logger")] = (_initProto(this), createLogger({
+  [(_setPerformanceModeDecs = trace(['enable']), _setBackgroundColorDecs = [trace(['color']), validateParams(stringSchema)], _setToolTypeDecs = [trace(['type']), validateParams(fcrBoardToolTypeSchema)], _setStrokeWidthDecs = [trace(['strokeWidth']), validateParams(numberSchema)], _setStrokeColorDecs = [trace(['color']), validateParams(z.union([colorSchema, stringSchema]))], _setTextColorDecs = [trace(['color']), validateParams(colorSchema)], _setTextSizeDecs = [trace(['textSize']), validateParams(numberSchema)], _insertImageDecs = [trace(['resourceUrl', 'x', 'y', 'width', 'height']), validateParams(stringSchema, numberSchema, numberSchema, numberSchema, numberSchema)], _setContainerSizeRatioDecs = [trace(['ratio']), validateParams(numberSchema)], _setBoardTransparentDecs = [trace(['isTransparent']), validateParams(booleanSchema)], _updateWindowSizeDecs = [trace(['size']), validateParams(fcrSizeSchema)], _setAutoCancelDrawDecs = [trace(['enable']), validateParams(booleanSchema)], _handleApplicationLaunchDecs = [bound, trace(['appId', 'app'])], _handleApplicationTerminalDecs = [bound, trace(['appId', 'app'])], _enableAutoCancelDecs = trace(['enable']), "logger")] = (_initProto(this), createLogger({
     prefix: 'FcrBoardMainWindowImpl'
   }));
   _observable = new AgoraObservable();
@@ -136,6 +136,16 @@ export class FcrBoardMainWindowImpl {
       throw new Error('Whiteboard is not initialized');
     }
   }
+
+  /**
+   * 设置性能模式状态, enabled 为 true 时开启性能模式, 否则关闭性能模式
+   * 性能模式下, 白板会降低渲染质量及同步频率以提升性能, 适用于低性能设备或需要大量绘制元素的场景
+   * @param enable 是否开启性能模式
+   */
+  setPerformanceMode(enable) {
+    this._whiteboard.setPerformanceMode(enable);
+    return FcrReturnCode.SUCCESS;
+  }
   async setBackgroundColor(color) {
     this._background = color;
     this.logger.info(`set canvas background color: ${this._background}`);

package/lib-es/service/api.js

@@ -250,6 +250,24 @@ export class FcrCoreServiceApi {
       method: 'PUT'
     });
   }
+  async startClientRecording(roomId, userId) {
+    return this._client.fetch({
+      path: `/v1/rooms/${roomId}/users/${userId}/widgets/clientRecording/1`,
+      method: 'PUT'
+    });
+  }
+  async resumeClientRecording(roomId, userId) {
+    return this._client.fetch({
+      path: `/v1/rooms/${roomId}/users/${userId}/widgets/clientRecording/resume`,
+      method: 'PUT'
+    });
+  }
+  async stopClientRecording(roomId, userId) {
+    return this._client.fetch({
+      path: `/v1/rooms/${roomId}/users/${userId}/widgets/clientRecording/0`,
+      method: 'PUT'
+    });
+  }
   async setCloudRecordingReady(roomId) {
     return this._client.fetch({
       path: `/v1/rooms/${roomId}/records/ready`,
@@ -644,6 +662,36 @@ export class FcrCoreServiceApi {
     });
     return res.data;
   }
+  async allowClientRecording({
+    roomId,
+    enable,
+    permissionType,
+    targetRoles
+  }) {
+    const res = await this._client.fetch({
+      path: `/v1/rooms/${roomId}/security/clientRecording/${enable}`,
+      method: 'PUT',
+      data: {
+        targetRoles,
+        selectType: permissionType
+      }
+    });
+    return res.data;
+  }
+  async allowClientRecordingByUserId({
+    roomId,
+    toUserUuids,
+    enable
+  }) {
+    const res = await this._client.fetch({
+      path: `/v1/rooms/${roomId}/security/clientRecording/users/${enable ? 1 : 0}`,
+      method: 'PUT',
+      data: {
+        toUserUuids
+      }
+    });
+    return res.data;
+  }
   async allowJoinWithPromptSound({
     roomId,
     enable,

package/lib-es/utilities/parameters.js

@@ -27,16 +27,26 @@ const DEFAULT_LOG_FILE_SIZE = 512;
 /** RTC preset parameters configuration mapping table */
 const RTC_PRESET_PARAMS_MAP = {
   [FcrApplicationPlatform.WINDOWS]: [{
-    'rtc.video.default_hw_decoder_thres': 921600
-  }, {
-    'rtc.video.h264_hw_min_res_level': 4
+    'engine.video.hw_decoder_fallback_config': {
+      max_instances_thres: -1,
+      width_thres: 540,
+      height_thres: 540,
+      decode_time_delay_thres_broadcaster: -1,
+      decode_time_delay_thres_audience: -1
+    }
   }],
   [FcrApplicationPlatform.MACOS]: [{
     'che.video.screenCaptureMode': 1
   }, {
     'che.video.screen_disable_frame_transparent_check': true
   }, {
-    'rtc.video.h264_hw_min_res_level': 4
+    'engine.video.hw_decoder_fallback_config': {
+      max_instances_thres: -1,
+      width_thres: 540,
+      height_thres: 540,
+      decode_time_delay_thres_broadcaster: -1,
+      decode_time_delay_thres_audience: -1
+    }
   }],
   [FcrApplicationPlatform.WEB_DESKTOP]: [{
     RESTRICTION_SET_PLAYBACK_DEVICE: false
@@ -95,6 +105,9 @@ const ELECTRON_COMMON_PARAMS = [
   'rtc.video.videoFullrange': 1
 }, {
   'rtc.video.matrixCoefficients': 5
+}, {
+  'rtc.stream_sub_remote_stats': false,
+  'rtc.stream_pub_local_stats': false
 }];
 
 /** ELECTRON platforms set */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fcr-core",
   "description": "Core APIs for building online scenes",
-  "version": "3.10.2",
+  "version": "3.11.0-rc.2",
   "module": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
@@ -18,6 +18,7 @@
   "author": "agora.io",
   "license": "MIT",
   "scripts": {
+    "check:ai-kb": "node ./scripts/check-ai-kb.js",
     "prepare": "husky",
     "build": "agora-tc-transpile --esm",
     "build:docs": "run-s build:docs:types build:split:i18n build:link-plugin build:en-docs build:cn-docs build:docs:generate",
@@ -28,7 +29,8 @@
     "build:en-docs": "typedoc --entryPoints ./build-doc/en-sdk.d.ts --readme ./build-doc/readme-en.md --hideGenerator --name 'Edu Store Typescript API Reference for Web' --tsconfig ./build-doc/en/tsconfig.json --out en-docs --excludeExternals --excludePrivate --excludeInternal --excludeProtected --disableSources --theme typedoc-theme",
     "build:cn-docs": "typedoc --entryPoints ./build-doc/cn-sdk.d.ts --readme ./build-doc/readme-cn.md --hideGenerator --name 'Edu Store Typescript API Reference for Web' --tsconfig ./build-doc/cn/tsconfig.json --out cn-docs --excludeExternals --excludePrivate --excludeInternal --excludeProtected --disableSources --theme typedoc-theme",
     "test-browser": "agora-tc-test-karma-browser",
-    "test-electron": "agora-tc-test-karma-electron"
+    "test-electron": "agora-tc-test-karma-electron",
+    "preinstall": "node ./scripts/check-ai-kb.js"
   },
   "devDependencies": {
     "@babel/core": "^7.23.5",
@@ -41,7 +43,7 @@
     "@types/lodash": "^4.14.168",
     "@types/sinon": "^17.0.2",
     "@types/uuid": "^8.3.0",
-    "agora-toolchain": "3.10.2",
+    "agora-toolchain": "3.11.0-rc.2",
     "core-js": "^3.33.3",
     "decomment": "^0.9.5",
     "husky": "^9.0.11",
@@ -55,14 +57,14 @@
   "dependencies": {
     "@netless/app-slide": "^0.2.81",
     "@netless/appliance-plugin": "^1.1.21",
-    "@netless/forge-room": "1.2.0-alpha.1",
-    "@netless/forge-rtm": "1.2.0-alpha.1",
-    "@netless/forge-whiteboard": "1.2.0-alpha.1",
+    "@netless/forge-room": "1.2.0-beta.3",
+    "@netless/forge-rtm": "1.2.0-beta.3",
+    "@netless/forge-whiteboard": "1.2.0-beta.3",
     "@netless/video-js-plugin": "^0.3.8",
     "@netless/white-snapshot": "^0.4.2",
     "@netless/window-manager": "^1.0.7-beta.6",
-    "agora-foundation": "3.10.2",
-    "agora-rte-sdk": "3.10.2",
+    "agora-foundation": "3.11.0-rc.2",
+    "agora-rte-sdk": "3.11.0-rc.2",
     "await-to-js": "^3.0.0",
     "dayjs": "^1.10.4",
     "easemob-websdk": "4.13.0",