fcr-core 3.10.2 → 3.11.0-rc.2

package/lib/imports.d.ts

@@ -27,7 +27,13 @@ export { sleep, jsonstring, randomString } from 'agora-foundation/lib/utilities/
 export { z, ZodError, anySchema, booleanSchema, numberSchema, stringSchema, fcrRenderViewSchema, unknownSchema, objectSchema, createRecordSchemaWithKey, createUnionSchema, createArraySchema, } from 'agora-foundation/lib/utilities/schema';
 export { validateParams } from 'agora-foundation/lib/decorator/validate';
 export { Mutex } from 'agora-foundation/lib/worker/mutex';
-export type { AgoraRtcNetworkStats, AgoraRtcDeviceInfo, AgoraRtcDisplayInfo, AgoraRtcWindowInfo, AgoraRtePerformanceInfo, AgoraRteScenePropertiesDeletedEvent, AgoraRteStreamEncryptionConfig, AgoraRteStreamJoinConfig, AgoraRteDualVideoStreamConfig, AgoraRteMessage, AgoraRteScenePropertiesUpdatedEvent, AgoraRteRenderView, AgoraRteScene, } from 'agora-rte-sdk';
+export type { AgoraRtcNetworkStats, AgoraRtcDeviceInfo, AgoraRtcDisplayInfo, AgoraRtcWindowInfo, AgoraRtePerformanceInfo, AgoraRteScenePropertiesDeletedEvent, AgoraRteStreamEncryptionConfig, AgoraRteStreamJoinConfig, AgoraRteDualVideoStreamConfig, AgoraRteMessage, AgoraRteScenePropertiesUpdatedEvent, AgoraRteRenderView, AgoraRteScene, AgoraRteClientRecordingConfig, AgoraRteClientRecordingObserver, AgoraRteRecorderInfo, } from 'agora-rte-sdk';
+export { AgoraRteRecorderState, AgoraRteRecorderReasonCode } from 'agora-rte-sdk';
+export type { AgoraRteClientRecordingConfig as FcrClientRecordingConfig } from 'agora-rte-sdk';
+export type { AgoraRteClientRecordingObserver as FcrClientRecordingObserver } from 'agora-rte-sdk';
+export type { AgoraRteRecorderInfo as FcrRecorderInfo } from 'agora-rte-sdk';
+export { AgoraRteRecorderState as FcrRecorderState } from 'agora-rte-sdk';
+export { AgoraRteRecorderReasonCode as FcrRecorderReasonCode } from 'agora-rte-sdk';
 export type { AgoraRtmClient } from 'agora-rte-sdk/lib/core/rtm/client';
 export type { AgoraRteEngineObserver } from 'agora-rte-sdk/lib/core/engine/type';
 export type { AgoraRteNetworkQualityEvent } from 'agora-rte-sdk/lib/core/scene/type';

package/lib/imports.js

@@ -150,6 +150,18 @@ Object.defineProperty(exports, "AgoraRteMediaStreamType", {
     return _type.AgoraRteMediaStreamType;
   }
 });
+Object.defineProperty(exports, "AgoraRteRecorderReasonCode", {
+  enumerable: true,
+  get: function () {
+    return _agoraRteSdk.AgoraRteRecorderReasonCode;
+  }
+});
+Object.defineProperty(exports, "AgoraRteRecorderState", {
+  enumerable: true,
+  get: function () {
+    return _agoraRteSdk.AgoraRteRecorderState;
+  }
+});
 Object.defineProperty(exports, "AgoraRteRegion", {
   enumerable: true,
   get: function () {
@@ -294,6 +306,18 @@ Object.defineProperty(exports, "FcrRTMProvider_2_2", {
     return _forgeRtm.RTMProvider_2_2;
   }
 });
+Object.defineProperty(exports, "FcrRecorderReasonCode", {
+  enumerable: true,
+  get: function () {
+    return _agoraRteSdk.AgoraRteRecorderReasonCode;
+  }
+});
+Object.defineProperty(exports, "FcrRecorderState", {
+  enumerable: true,
+  get: function () {
+    return _agoraRteSdk.AgoraRteRecorderState;
+  }
+});
 Object.defineProperty(exports, "FcrRoom", {
   enumerable: true,
   get: function () {
@@ -587,9 +611,9 @@ var _misc = require("agora-foundation/lib/utilities/misc");
 var _schema = require("agora-foundation/lib/utilities/schema");
 var _validate = require("agora-foundation/lib/decorator/validate");
 var _mutex = require("agora-foundation/lib/worker/mutex");
+var _agoraRteSdk = require("agora-rte-sdk");
 var _error = require("agora-rte-sdk/lib/core/utilities/error");
 var _agoraError = require("agora-foundation/lib/utilities/error/agora-error");
-var _agoraRteSdk = require("agora-rte-sdk");
 var _type = require("agora-rte-sdk/lib/core/scene/type");
 var _type2 = require("agora-rte-sdk/lib/core/rtc/type");
 var _type3 = require("agora-rte-sdk/lib/type");
@@ -619,4 +643,6 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 
 // Agora RTE exports
 
+// Fcr-prefixed re-exports for edu-core layer
+
 const localStorage = exports.localStorage = window.localStorage;

package/lib/index.d.ts

@@ -1,4 +1,6 @@
 export type { FcrDesktopMediaControl, FcrDesktopMediaObserver, FcrMobileMediaControl, FcrMobileMediaObserver, FcrMonitorControl, FcrMonitorObserver, FcrBaseRoomControl, FcrRoomObserver, FcrUserControl, FcrUserObserver, FcrStreamControl, FcrStreamObserver, FcrPrivilegeControl, FcrPermission, FcrBoardMainWindow, FcrBoardMainWindowObserver, FcrColor, } from './type';
+export type { FcrClientRecordingConfig } from './imports';
+export { FcrRecorderState, FcrRecorderReasonCode } from './imports';
 export { FcrStreamLatencyLevel, FcrPermissionAction, FcrPrivilegeUserRole, FcrUserRole, FcrStreamState, FcrRegion, FcrStreamType, FcrUserUpdatedReason, FcrRoomConnectorType, FcrVideoSourceType, FcrAudioSourceType, FcrMediaSourceState, FcrVideoRenderMode, FcrVideoStreamType, FcrCapability, FcrAiDenoiseLevel, FcrStreamPrivilegeOperation, FcrStreamPrivilegeVideoSourceType, FcrStreamPrivilegeAudioSourceType, FcrConnectionState, registerPlugin, FcrBoardToolType, FcrBoardShape, FcrVideoEncoderConfig, FcrDualVideoStreamConfig, } from './type';
 export { FcrCoreEngineImpl as FcrCoreEngine } from './engine';
 export { FcrCoreEngineConfig } from './struct';

package/lib/index.js

@@ -87,6 +87,18 @@ Object.defineProperty(exports, "FcrPrivilegeUserRole", {
     return _type.FcrPrivilegeUserRole;
   }
 });
+Object.defineProperty(exports, "FcrRecorderReasonCode", {
+  enumerable: true,
+  get: function () {
+    return _imports.FcrRecorderReasonCode;
+  }
+});
+Object.defineProperty(exports, "FcrRecorderState", {
+  enumerable: true,
+  get: function () {
+    return _imports.FcrRecorderState;
+  }
+});
 Object.defineProperty(exports, "FcrRegion", {
   enumerable: true,
   get: function () {
@@ -183,8 +195,8 @@ Object.defineProperty(exports, "registerPlugin", {
     return _type.registerPlugin;
   }
 });
+var _imports = require("./imports");
 var _type = require("./type");
 var _engine = require("./engine");
 var _struct = require("./struct");
-var _schema = require("./schema");
-var _imports = require("./imports");
+var _schema = require("./schema");

package/lib/room-control/helpers/constants.d.ts

@@ -44,6 +44,14 @@ export declare const ROOM_MESSAGE_COMMANDS: {
     readonly LIVE_STREAMING_UPDATE: 700;
     /** 用户被踢出命令 */
     readonly USER_KICK_OUT: 5;
+    /** 用户widget属性更新命令（widget属性变更的通用cause.cmd） */
+    readonly USER_WIDGET_PROPERTIES_UPDATE: 10;
+    /** 客户端录制权限变更（角色级, cause.cmd=3260） */
+    readonly CLIENT_RECORDING_PERMISSION: 3260;
+    /** 客户端录制状态变更 cause.data.widgetCause.cmd=3261 (通过widget属性下发) */
+    readonly CLIENT_RECORDING_STATE: 3261;
+    /** 用户权限变更（用户级，含客户端录制） */
+    readonly USER_PERMISSION_UPDATE: 3121;
     /** 房间会话请求命令 */
     readonly ROOM_SESSION_REQUEST: 1001;
     /** 房间会话接受命令 */

package/lib/room-control/helpers/constants.js

@@ -53,6 +53,14 @@ const ROOM_MESSAGE_COMMANDS = exports.ROOM_MESSAGE_COMMANDS = {
   LIVE_STREAMING_UPDATE: 700,
   /** 用户被踢出命令 */
   USER_KICK_OUT: 5,
+  /** 用户widget属性更新命令（widget属性变更的通用cause.cmd） */
+  USER_WIDGET_PROPERTIES_UPDATE: 10,
+  /** 客户端录制权限变更（角色级, cause.cmd=3260） */
+  CLIENT_RECORDING_PERMISSION: 3260,
+  /** 客户端录制状态变更 cause.data.widgetCause.cmd=3261 (通过widget属性下发) */
+  CLIENT_RECORDING_STATE: 3261,
+  /** 用户权限变更（用户级，含客户端录制） */
+  USER_PERMISSION_UPDATE: 3121,
   /** 房间会话请求命令 */
   ROOM_SESSION_REQUEST: 1001,
   /** 房间会话接受命令 */

package/lib/room-control/index.js

@@ -24,7 +24,9 @@ require("core-js/modules/es.array.includes.js");
 require("core-js/modules/es.array.push.js");
 require("core-js/modules/es.json.stringify.js");
 require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.find.js");
 require("core-js/modules/esnext.iterator.for-each.js");
+require("core-js/modules/esnext.iterator.some.js");
 var _imports = require("../imports");
 var _type = require("../type");
 var _type2 = require("./type");
@@ -68,7 +70,7 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
  */
 class FcrBaseRoomControlImpl {
   static {
-    [_initProto] = _applyDecs(this, [[_imports.trace, 2, "getSyncTimestamp"], [_imports.trace, 2, "getRoomInfo"], [_imports.trace, 2, "getRoomSchedule"], [_imports.trace, 2, "getLocalExDataSyncTypeList"], [_joinDecs, 2, "join"], [_imports.trace, 2, "leave"], [_imports.trace, 2, "release"], [_imports.trace, 2, "start"], [_imports.trace, 2, "end"], [_imports.trace, 2, "close"], [_imports.trace, 2, "getRoomState"], [_imports.trace, 2, "getRoomProperties"], [_imports.trace, 2, "getRoomPropertiesByKeyPath"], [_updateRoomPropertiesDecs, 2, "updateRoomProperties"], [_updateIncrementRoomPropertiesDecs, 2, "updateIncrementRoomProperties"], [_deleteRoomPropertiesDecs, 2, "deleteRoomProperties"], [_startCloudRecordingDecs, 2, "startCloudRecording"], [_imports.trace, 2, "pauseCloudRecording"], [_imports.trace, 2, "resumeCloudRecording"], [_imports.trace, 2, "stopCloudRecording"], [_imports.trace, 2, "getLiveStreamingState"], [_imports.trace, 2, "getLiveStreamingConfig"], [_startLiveStreamingDecs, 2, "startLiveStreaming"], [_updateLiveStreamingLayoutDecs, 2, "updateLiveStreamingLayout"], [_imports.trace, 2, "stopLiveStreaming"], [_imports.trace, 2, "getCloudRecordingState"], [_sendRoomMessageDecs, 2, "sendRoomMessage"]], []).e;
+    [_initProto] = _applyDecs(this, [[_imports.trace, 2, "getSyncTimestamp"], [_imports.trace, 2, "getRoomInfo"], [_imports.trace, 2, "getRoomSchedule"], [_imports.trace, 2, "getLocalExDataSyncTypeList"], [_joinDecs, 2, "join"], [_imports.trace, 2, "leave"], [_imports.trace, 2, "release"], [_imports.trace, 2, "start"], [_imports.trace, 2, "end"], [_imports.trace, 2, "close"], [_imports.trace, 2, "getRoomState"], [_imports.trace, 2, "getRoomProperties"], [_imports.trace, 2, "getRoomPropertiesByKeyPath"], [_updateRoomPropertiesDecs, 2, "updateRoomProperties"], [_updateIncrementRoomPropertiesDecs, 2, "updateIncrementRoomProperties"], [_deleteRoomPropertiesDecs, 2, "deleteRoomProperties"], [_startCloudRecordingDecs, 2, "startCloudRecording"], [_imports.trace, 2, "pauseCloudRecording"], [_imports.trace, 2, "resumeCloudRecording"], [_imports.trace, 2, "stopCloudRecording"], [_imports.trace, 2, "startClientRecording"], [_imports.trace, 2, "resumeClientRecording"], [_imports.trace, 2, "stopClientRecording"], [_imports.trace, 2, "getLiveStreamingState"], [_imports.trace, 2, "getLiveStreamingConfig"], [_startLiveStreamingDecs, 2, "startLiveStreaming"], [_updateLiveStreamingLayoutDecs, 2, "updateLiveStreamingLayout"], [_imports.trace, 2, "stopLiveStreaming"], [_imports.trace, 2, "hasActiveClientRecording"], [_imports.trace, 2, "getCloudRecordingState"], [_sendRoomMessageDecs, 2, "sendRoomMessage"]], []).e;
   }
   //@internal
   [(_joinDecs = (0, _imports.trace)(['options']), _updateRoomPropertiesDecs = (0, _imports.trace)(['properties', 'cause']), _updateIncrementRoomPropertiesDecs = (0, _imports.trace)(['increments', 'cause']), _deleteRoomPropertiesDecs = (0, _imports.trace)(['properties', 'cause']), _startCloudRecordingDecs = (0, _imports.trace)(['config']), _startLiveStreamingDecs = (0, _imports.trace)(['data']), _updateLiveStreamingLayoutDecs = (0, _imports.trace)(['layoutType']), _sendRoomMessageDecs = (0, _imports.trace)(['payload', 'guaranteedDelivery']), "logger")] = (_initProto(this), (0, _logger.createLogger)({
@@ -78,6 +80,8 @@ class FcrBaseRoomControlImpl {
   _joinRoomSuccess = false;
   _joining = false;
   _joinState = _helpers.ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+  _isClientRecordingOwner = false;
+  _isStartingClientRecording = false;
   constructor(_engine, _scene, _api, _config, _roomType, _chatConnection, _sharedCache, _chatRoomControl) {
     this._engine = _engine;
     this._scene = _scene;
@@ -226,8 +230,45 @@ class FcrBaseRoomControlImpl {
           this._joinState = _helpers.ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
           this._cleanup();
         }
+        // Handle user-level local recording permission change (cmd=3121)
+        if (event.cause?.cmd === _helpers.ROOM_MESSAGE_COMMANDS.USER_PERMISSION_UPDATE && event.modifiedUser.userId === this._scene.localUser.getLocalUserId()) {
+          const causeData = event.cause?.data;
+          if (causeData?.removePermissions?.includes('record:startClientRecording')) {
+            if (this.isLocalClientRecordingActive()) {
+              this.stopClientRecording().catch(e => {
+                this.logger.error(`auto-stop client recording failed: ${e.message}`);
+              });
+            }
+          }
+        }
+      }
+    };
+
+    // 初始化客户端录制观察者
+    this._clientRecordingObserver = {
+      onRecorderStateChanged: (_channelId, _uid, state, reason) => {
+        this.logger.info(`onRecorderStateChanged: state=${state}, reason=${reason}, sceneId=${this._scene.sceneId}`);
+        this._observable.notifyObservers('onClientRecordingStateChanged', this._scene.sceneId, state, reason);
       }
     };
+
+    // 客户端录制观察者由子类（FcrMainRoomControlImpl）注册，基类不注册
+  }
+
+  /**
+   * 注册客户端录制观察者。由主房间子类在构造时调用。
+   */
+  _registerClientRecordingObserver() {
+    this._engine.getMediaControl().addClientRecordingObserver(this._clientRecordingObserver);
+    this._isClientRecordingOwner = true;
+  }
+
+  /**
+   * 移除客户端录制观察者。由 _cleanup 调用时需要判断是否已注册。
+   */
+  _unregisterClientRecordingObserver() {
+    this._engine.getMediaControl().removeClientRecordingObserver(this._clientRecordingObserver);
+    this._isClientRecordingOwner = false;
   }
 
   /**
@@ -574,6 +615,89 @@ class FcrBaseRoomControlImpl {
     await (0, _error.handleRequestError)(() => this._api.stopCloudRecording(this._scene.sceneId), _imports.ErrorModuleCode.FCR_ROOM, 'stop cloud recording failed');
     return _type.FcrReturnCode.SUCCESS;
   }
+  async startClientRecording(config) {
+    // 防止并发调用
+    if (this._isStartingClientRecording) {
+      this.logger.warn('startClientRecording: already starting, ignoring duplicate call');
+      return _type.FcrReturnCode.SUCCESS;
+    }
+    const localUserId = this._scene.localUser.getLocalUserId();
+
+    // 标记正在启动本地录制，避免在 API 调用后、SDK 录制开始前的时间窗口内触发错误的提示
+    this._isStartingClientRecording = true;
+    let serverRecordingStarted = false;
+    try {
+      await (0, _error.handleRequestError)(() => this._api.startClientRecording(this._scene.sceneId, localUserId), _imports.ErrorModuleCode.FCR_ROOM, 'start client recording failed');
+      serverRecordingStarted = true;
+
+      // 使用 mediaControl 来启动本地录制
+      const mediaControl = this._engine.getMediaControl();
+      const isScreenShareActive = mediaControl.isScreenShareActive();
+      const currentScreenShareSourceId = mediaControl.getCurrentScreenShareSourceId();
+
+      // 获取本地用户的主流 streamId 作为录制 uid（streamId 是数字，userUuid 可能是十六进制字符串）
+      const localStreams = this._scene.getStreamsByUserId(localUserId);
+      const mainStream = localStreams.find(s => s.videoSourceType === _imports.AgoraRteVideoSourceType.CAMERA) || localStreams[0];
+      if (!mainStream) {
+        throw new Error(`No stream found for local user: ${localUserId}`);
+      }
+      const uid = Number(mainStream.streamId);
+      await mediaControl.startClientRecording(this._scene.sceneId, uid, config, isScreenShareActive, currentScreenShareSourceId);
+      return _type.FcrReturnCode.SUCCESS;
+    } catch (e) {
+      // API 调用成功但 SDK 启动失败时，回滚服务端状态
+      if (serverRecordingStarted) {
+        this.logger.error(`startClientRecording SDK failed, rolling back server state: ${e.message}`);
+        this._api.stopClientRecording(this._scene.sceneId, localUserId).catch(rollbackErr => {
+          this.logger.error(`startClientRecording rollback failed: ${rollbackErr.message}`);
+        });
+      }
+      throw e;
+    } finally {
+      this._isStartingClientRecording = false;
+    }
+  }
+  async resumeClientRecording() {
+    const localUserId = this._scene.localUser.getLocalUserId();
+    await (0, _error.handleRequestError)(() => this._api.resumeClientRecording(this._scene.sceneId, localUserId), _imports.ErrorModuleCode.FCR_ROOM, 'resume client recording failed');
+    return _type.FcrReturnCode.SUCCESS;
+  }
+  async stopClientRecording() {
+    const localUserId = this._scene.localUser.getLocalUserId();
+
+    // Step 1: 使用 mediaControl 的 stopClientRecording（即使失败也继续通知服务端）
+    const mediaControl = this._engine.getMediaControl();
+    try {
+      await mediaControl.stopClientRecording();
+    } catch (e) {
+      this.logger.error(`mediaControl.stopClientRecording failed: ${e.message}`);
+    }
+
+    // Step 2: 无论 SDK 停止是否成功，都通知服务器停止录制
+    await (0, _error.handleRequestError)(() => this._api.stopClientRecording(this._scene.sceneId, localUserId), _imports.ErrorModuleCode.FCR_ROOM, 'stop client recording failed');
+    return _type.FcrReturnCode.SUCCESS;
+  }
+  isLocalClientRecordingActive() {
+    // 如果正在启动本地录制，也返回 true，避免在启动过程中触发错误的"其他人开启录制"提示
+    const mediaControl = this._engine.getMediaControl();
+    return this._isStartingClientRecording || mediaControl.isClientRecordingActive();
+  }
+  isClientRecordingOwnsCapture() {
+    const mediaControl = this._engine.getMediaControl();
+    return mediaControl.isClientRecordingOwnsCapture();
+  }
+  async resumeClientRecordingOwnCapture() {
+    const mediaControl = this._engine.getMediaControl();
+    await mediaControl.resumeClientRecordingOwnCapture();
+  }
+  async waitForScreenCaptureStopped() {
+    const mediaControl = this._engine.getMediaControl();
+    await mediaControl.waitForScreenCaptureStopped();
+  }
+  releaseClientRecordingOwnCapture() {
+    const mediaControl = this._engine.getMediaControl();
+    mediaControl.releaseClientRecordingOwnCapture();
+  }
   getLiveStreamingState() {
     let liveStreamingState = this._scene.getScenePropertiesByKeyPath('live.state');
     if (liveStreamingState === _helpers.LIVE_STREAMING_STATE_VALUES.STARTED) {
@@ -613,6 +737,11 @@ class FcrBaseRoomControlImpl {
     await this._liveStreamingAction(() => this._api.stopLiveStreaming(this._scene.sceneId), 'stop live streaming failed');
     return _type.FcrReturnCode.SUCCESS;
   }
+  hasActiveClientRecording() {
+    const userControl = this.getUserControl();
+    const users = userControl.getUserList();
+    return users.some(user => userControl.getUserClientRecordingState(user.userId));
+  }
   getCloudRecordingState() {
     const {
       state,
@@ -641,6 +770,21 @@ class FcrBaseRoomControlImpl {
   async _cleanup() {
     this._scene.removeObserver(this._sceneObserver);
     this._engine.removeObserver(this._engineObserver);
+
+    // 只有注册过录制观察者的 room control 才拥有录制生命周期，
+    // 其他房间（如等候室）的 cleanup 不应停止共享 mediaControl 上的录制。
+    if (this._isClientRecordingOwner) {
+      this._unregisterClientRecordingObserver();
+      try {
+        const mediaControl = this._engine.getMediaControl();
+        if (mediaControl.isClientRecordingActive()) {
+          await mediaControl.stopClientRecording();
+          this.logger.info('_cleanup: stopped client recording');
+        }
+      } catch (e) {
+        this.logger.error(`_cleanup: failed to stop client recording: ${e.message}`);
+      }
+    }
     this._sharedCache.getRoomCache(this._scene.sceneId).clear();
     try {
       return await Promise.all([this._chatRoomControl?.leave(), this.sharingControl?.getBoardControl().close(), this.sharingControl?.getAnnotationControl().close(), this._scene.leave()]);

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

@@ -60,6 +60,7 @@ class FcrInfinityRoomControlImpl extends _.FcrBaseRoomControlImpl {
     this._interpreterControl = new _interpreterControl.FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
     this._addLogObserver();
     (0, _boardInitInfoHelper.addBoardInitInfoObserver)(this._scene, this._api, this.logger);
+    this._registerClientRecordingObserver();
     this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
   }
   getAnnouncement() {
@@ -114,13 +115,11 @@ class FcrInfinityRoomControlImpl extends _.FcrBaseRoomControlImpl {
   _onLocalUserPermissionInfoDeleted(roomId, event) {
     if ((0, _utils.hasBoardWritePermission)(event.permissionInfo)) {
       this.logger.info(`remove board write permission`);
-
-      // this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
     }
     if ((0, _utils.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/room-control/mainroom-control/index.js

@@ -71,6 +71,7 @@ class FcrMainRoomControlImpl extends _.FcrBaseRoomControlImpl {
     this._interpreterControl = new _interpreterControl.FcrInterpreterControlImpl(api, scene, config, engine, chatConnection, sharedCache);
     this._addLogObserver();
     (0, _boardInitInfoHelper.addBoardInitInfoObserver)(this._scene, this._api, this.logger);
+    this._registerClientRecordingObserver();
     this.logger.info(`initialized, room id: ${this._scene.sceneId}`);
   }
 
@@ -138,13 +139,11 @@ class FcrMainRoomControlImpl extends _.FcrBaseRoomControlImpl {
   _onLocalUserPermissionInfoDeleted(roomId, event) {
     if ((0, _utils2.hasBoardWritePermission)(event.permissionInfo)) {
       this.logger.info(`remove board write permission`);
-
-      // this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
+      this.getSharingControl().getBoardControl().getMainWindow()?.setWritable(false);
     }
     if ((0, _utils2.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/room-control/privilege-control/index.js

@@ -34,7 +34,7 @@ var _user = require("../../utilities/user");
 var _validateParams = _interopRequireDefault(require("../../utilities/validate-params"));
 var _helper = require("./helper");
 var _type2 = require("./type");
-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;
 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); }
@@ -45,10 +45,10 @@ function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side
  */
 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"], [_imports.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"], [_imports.trace, 2, "release"]], []).e;
   }
   //@internal
-  [(_allowWriteAnnotationDecs = (0, _imports.trace)(['enable', 'targetRoles']), _getSecurityInfoDecs = [(0, _imports.trace)(['action']), (0, _validateParams.default)(_schema.fcrSecurityActionSchema)], _getLocalUserPermissionInfoDecs = [(0, _imports.trace)(['action']), (0, _validateParams.default)(_schema.fcrPermissionActionSchema)], _enableLockedRoomDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowShareAndWriteDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardByUserIdsDecs = [(0, _imports.trace)(['enable', 'targetUserIds']), (0, _validateParams.default)(_schema.booleanSchema, _schema.stringArraySchema)], _allowSendChatDecs = [(0, _imports.trace)(['enable', 'targetRoles', 'payload']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema, _schema.fcrSecuritySendChatPayloadSchema)], _allowStartAudioDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartVideoDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedAudioDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedVideoDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWatermarkDecs = [(0, _imports.trace)(['enable', 'targetRoles', 'lineType']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema, _schema.fcrLineTypeSchema.optional())], _allowChangeUserNameDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartCaptionDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartTranscribingDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowUpdateSttSourceLanguageDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithPromptSoundDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _getRemoteUserPermissionEnableDecs = (0, _imports.trace)(['userId', 'type']), _allowViewUserCountDecs = (0, _imports.trace)(['enable', 'targetRoles']), _allowHandsUpDecs = (0, _imports.trace)(['enable', 'targetRoles']), _allowSendChatByUserRoleDecs = (0, _imports.trace)(['config', 'targetRoles']), _allowSendChatByUserIdDecs = (0, _imports.trace)(['enable', 'userId']), "logger")] = (_initProto(this), (0, _logger.createLogger)({
+  [(_allowWriteAnnotationDecs = (0, _imports.trace)(['enable', 'targetRoles']), _getSecurityInfoDecs = [(0, _imports.trace)(['action']), (0, _validateParams.default)(_schema.fcrSecurityActionSchema)], _getLocalUserPermissionInfoDecs = [(0, _imports.trace)(['action']), (0, _validateParams.default)(_schema.fcrPermissionActionSchema)], _enableLockedRoomDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowShareAndWriteDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWriteBoardByUserIdsDecs = [(0, _imports.trace)(['enable', 'targetUserIds']), (0, _validateParams.default)(_schema.booleanSchema, _schema.stringArraySchema)], _allowSendChatDecs = [(0, _imports.trace)(['enable', 'targetRoles', 'payload']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema, _schema.fcrSecuritySendChatPayloadSchema)], _allowStartAudioDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartVideoDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedAudioDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithMutedVideoDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowWatermarkDecs = [(0, _imports.trace)(['enable', 'targetRoles', 'lineType']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema, _schema.fcrLineTypeSchema.optional())], _allowChangeUserNameDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartCaptionDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowStartTranscribingDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowUpdateSttSourceLanguageDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowJoinWithPromptSoundDecs = [(0, _imports.trace)(['enable', 'targetRoles']), (0, _validateParams.default)(_schema.booleanSchema, _schema.fcrPrivilegeUserRoleArraySchema)], _allowClientRecordingDecs = (0, _imports.trace)(['permissionType']), _allowClientRecordingByUserIdDecs = (0, _imports.trace)(['userId', 'enable']), _getRemoteUserPermissionEnableDecs = (0, _imports.trace)(['userId', 'type']), _allowViewUserCountDecs = (0, _imports.trace)(['enable', 'targetRoles']), _allowHandsUpDecs = (0, _imports.trace)(['enable', 'targetRoles']), _allowSendChatByUserRoleDecs = (0, _imports.trace)(['config', 'targetRoles']), _allowSendChatByUserIdDecs = (0, _imports.trace)(['enable', 'userId']), "logger")] = (_initProto(this), (0, _logger.createLogger)({
     prefix: 'FcrPrivilegeControlImpl'
   }));
   _observable = new _imports.AgoraObservable();
@@ -260,6 +260,25 @@ class FcrPrivilegeControlImpl {
     }), _imports.ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow join with prompt sound failed');
     return _type.FcrReturnCode.SUCCESS;
   }
+  async allowClientRecording(permissionType) {
+    const enable = permissionType === _type2.FcrClientRecordingPermissionType.HostOnly ? 0 : 1;
+    const targetRoles = permissionType === _type2.FcrClientRecordingPermissionType.AllMembers ? [_type2.FcrPrivilegeUserRoleToStringMap[_type2.FcrPrivilegeUserRole.PARTICIPANT]] : undefined;
+    await (0, _error.handleRequestError)(() => this._api.allowClientRecording({
+      roomId: this._scene.sceneId,
+      permissionType,
+      enable,
+      targetRoles
+    }), _imports.ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow client recording failed');
+    return _type.FcrReturnCode.SUCCESS;
+  }
+  async allowClientRecordingByUserId(userId, enable) {
+    await (0, _error.handleRequestError)(() => this._api.allowClientRecordingByUserId({
+      roomId: this._scene.sceneId,
+      toUserUuids: [userId],
+      enable
+    }), _imports.ErrorModuleCode.FCR_ROOM_PRIVILEGE, 'allow client recording by user id failed');
+    return _type.FcrReturnCode.SUCCESS;
+  }
   getRemoteUserPermissionEnable(userId, type) {
     if (userId === this._scene.localUser.getLocalUserId()) {
       return false;

package/lib/room-control/privilege-control/type.d.ts

@@ -133,6 +133,17 @@ export interface FcrPrivilegeControl {
      * @param targetRoles
      */
     allowJoinWithPromptSound(enable: boolean, targetRoles: FcrPrivilegeUserRole[]): Promise<number>;
+    /**
+     * Sets client recording permission type (role-level).
+     * @param permissionType Permission type
+     */
+    allowClientRecording(permissionType: FcrClientRecordingPermissionType): Promise<number>;
+    /**
+     * Allows or disallows a specific user to do client recording.
+     * @param userId Target user ID
+     * @param enable true to allow, false to disallow
+     */
+    allowClientRecordingByUserId(userId: string, enable: boolean): Promise<number>;
     /**
      * Gets the remote user's permission enable.
      * @param userId
@@ -358,6 +369,9 @@ export declare enum FcrPermissionAction {
     RecordStopCloudRecording = "record:stopCloudRecording",
     RecordPauseCloudRecording = "record:pauseCloudRecording",
     RecordResumeCloudRecording = "record:resumeCloudRecording",
+    RecordStartClientRecording = "record:startClientRecording",
+    RecordStopClientRecording = "record:stopClientRecording",
+    RecordSetClientRecordingPermission = "record:setClientRecordingPermission",
     CallCallIn = "call:callIn",
     CallHangUp = "call:hangUp",
     CallInvite = "call:invite",
@@ -429,6 +443,7 @@ export declare enum FcrSecurityAction {
     SttStartCaption = "caption",
     SttStartTranscribe = "transcribe",
     JoinWithPromptSound = "joinWithPromptSound",
+    ClientRecording = "clientRecording",
     HandsUp = "handsUp",
     ViewUserCount = "viewUserCount"
 }
@@ -436,6 +451,11 @@ export declare enum FcrWatermarkPermissionState {
     ON = 1,
     OFF = 0
 }
+export declare enum FcrClientRecordingPermissionType {
+    HostOnly = 1,
+    AllMembers = 2,
+    SpecifiedMembers = 3
+}
 export declare enum FcrRemotePermissionType {
     SendChatToAll = 1,
     SendChatToCoParticipant = 2,

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.FcrWatermarkPermissionState = exports.FcrTargetUserTypeToStringMap = exports.FcrTargetUserType = exports.FcrSecurityAction = exports.FcrRoleFilter = exports.FcrRemotePermissionType = exports.FcrPrivilegeUserStringToRoleMap = exports.FcrPrivilegeUserRoleToStringMap = exports.FcrPrivilegeUserRole = exports.FcrPermissionAction = exports.FcrOperatePermissionType = exports.FcrExDataSyncType = exports.FcrChatPermissionType = void 0;
+exports.FcrWatermarkPermissionState = exports.FcrTargetUserTypeToStringMap = exports.FcrTargetUserType = exports.FcrSecurityAction = exports.FcrRoleFilter = exports.FcrRemotePermissionType = exports.FcrPrivilegeUserStringToRoleMap = exports.FcrPrivilegeUserRoleToStringMap = exports.FcrPrivilegeUserRole = exports.FcrPermissionAction = exports.FcrOperatePermissionType = exports.FcrExDataSyncType = exports.FcrClientRecordingPermissionType = exports.FcrChatPermissionType = void 0;
 let FcrTargetUserType = exports.FcrTargetUserType = /*#__PURE__*/function (FcrTargetUserType) {
   FcrTargetUserType[FcrTargetUserType["SELF"] = 1] = "SELF";
   FcrTargetUserType[FcrTargetUserType["HOST"] = 2] = "HOST";
@@ -118,6 +118,9 @@ let FcrPermissionAction = exports.FcrPermissionAction = /*#__PURE__*/function (F
   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";
@@ -183,6 +186,7 @@ let FcrSecurityAction = exports.FcrSecurityAction = /*#__PURE__*/function (FcrSe
   FcrSecurityAction["SttStartCaption"] = "caption";
   FcrSecurityAction["SttStartTranscribe"] = "transcribe";
   FcrSecurityAction["JoinWithPromptSound"] = "joinWithPromptSound";
+  FcrSecurityAction["ClientRecording"] = "clientRecording";
   FcrSecurityAction["HandsUp"] = "handsUp";
   FcrSecurityAction["ViewUserCount"] = "viewUserCount";
   return FcrSecurityAction;
@@ -192,6 +196,12 @@ let FcrWatermarkPermissionState = exports.FcrWatermarkPermissionState = /*#__PUR
   FcrWatermarkPermissionState[FcrWatermarkPermissionState["OFF"] = 0] = "OFF";
   return FcrWatermarkPermissionState;
 }({});
+let FcrClientRecordingPermissionType = exports.FcrClientRecordingPermissionType = /*#__PURE__*/function (FcrClientRecordingPermissionType) {
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["HostOnly"] = 1] = "HostOnly";
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["AllMembers"] = 2] = "AllMembers";
+  FcrClientRecordingPermissionType[FcrClientRecordingPermissionType["SpecifiedMembers"] = 3] = "SpecifiedMembers";
+  return FcrClientRecordingPermissionType;
+}({});
 let FcrRemotePermissionType = exports.FcrRemotePermissionType = /*#__PURE__*/function (FcrRemotePermissionType) {
   FcrRemotePermissionType[FcrRemotePermissionType["SendChatToAll"] = 1] = "SendChatToAll";
   FcrRemotePermissionType[FcrRemotePermissionType["SendChatToCoParticipant"] = 2] = "SendChatToCoParticipant";

package/lib/room-control/type.d.ts

@@ -1,4 +1,5 @@
 import { FcrError } from '..';
+import { FcrClientRecordingConfig, FcrRecorderState, FcrRecorderReasonCode } from '../imports';
 import { FcrRoomJoinOptionsSchema } from '../schema';
 import { FcrCloudRecordingConfig, FcrLiveStreamingConfig, FcrLiveStreamingLayoutType, FcrLiveStreamingState, FcrMessage, FcrNetworkQualityEvent, FcrNetworkStats, FcrRecordingState, FcrRoomInfo, FcrRoomJoinSnapshotOptions, FcrRoomPropertiesDeletedEvent, FcrRoomPropertiesUpdatedEvent, FcrRoomRouteSwitchEvent, FcrRoomSchedule, FcrRoomState } from '../type';
 import { FcrChatRoomControl } from './chatroom-control/type';
@@ -168,6 +169,42 @@ export interface FcrBaseRoomControl {
      * Gets the state of the cloud recording.
      */
     getCloudRecordingState(): FcrRecordingState;
+    /**
+     * Starts the client recording.
+     * @param config Optional recording configuration (screenSourceId, reuseScreenShare, storagePath, etc.)
+     */
+    startClientRecording(config?: FcrClientRecordingConfig): Promise<number>;
+    /**
+     * Stops the client recording.
+     */
+    stopClientRecording(): Promise<number>;
+    /**
+     * Check whether client recording is currently active.
+     * Screen share should call this before stopping capture — if true, keep capture alive.
+     */
+    isLocalClientRecordingActive(): boolean;
+    /**
+     * Check whether client recording owns its own screen capture.
+     */
+    isClientRecordingOwnsCapture(): boolean;
+    /**
+     * Resume recording's own window capture after it was released.
+     */
+    resumeClientRecordingOwnCapture(): Promise<void>;
+    /**
+     * Wait for the SDK's screen capture stopped callback.
+     * Must be called BEFORE stopScreenCapture to register the promise.
+     */
+    waitForScreenCaptureStopped(): Promise<void>;
+    /**
+     * Release the recording's own screen/window capture without stopping the recording.
+     * Called before starting screen share to free the capture resource.
+     */
+    releaseClientRecordingOwnCapture(): void;
+    /**
+     * Checks whether any user in the room is currently doing client recording.
+     */
+    hasActiveClientRecording(): boolean;
     /**
      * Sends a message to the room.
      * @param payload
@@ -303,6 +340,13 @@ export type FcrRoomObserver = {
      * @param type
      */
     onLocalExDataSyncTypeRemoved?(roomId: string, syncTypeInfo: FcrExDataSyncType): void;
+    /**
+     * Callback to receive the client recording state changed event.
+     * @param roomId The room ID
+     * @param state The recorder state
+     * @param reason The reason for the state change
+     */
+    onClientRecordingStateChanged?(roomId: string, state: FcrRecorderState, reason: FcrRecorderReasonCode): void;
 };
 export type FcrWaitingRoomObserver = FcrRoomObserver & {};
 export type FcrJoinBeforeHostWaitingRoomObserver = FcrRoomObserver & {};