fcr-core 3.10.6 → 3.11.0-rc.10

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, FcrBatchResult, FcrStreamUpdateResultDetail, } 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/media-control/type.d.ts

@@ -163,6 +163,12 @@ export interface FcrAudioEffectEnhancer {
      * Disables AGC for the audio track.
      */
     disableAGC(): void;
+    /**
+     * Sets the Windows system-level audio preprocessing (hardware 3A) mode.
+     * Only effective on Electron Windows.
+     * @param mode `0` off (default), `1` on, `2` only enabled under speaker routing.
+     */
+    setWindowsSystemAudioPreprocessingMode(mode: number): void;
 }
 export interface FcrVideoEffectEnhancer {
     /**
@@ -404,8 +410,9 @@ export interface FcrMicrophoneTrack {
     /**
      * Starts the microphone test for the specified device.
      * @param interval The interval for the microphone test.
+     * @param enablePlayback Whether to enable playback during the test.
      */
-    startTest(interval: number): number;
+    startTest(interval: number, enablePlayback?: boolean): number;
     /**
      * Stops the microphone test for the specified device.
      */

package/lib/peer-session/index.js

@@ -326,6 +326,10 @@ class FcrPeerSessionControlImpl {
       data,
       cmd
     } = payload;
+    if (cmd !== '1001' && cmd !== '1002' || !data || typeof data.sessionKey !== 'string' || typeof data.sessionUuid !== 'string') {
+      this.logger.info(`[PeerSession] ignore non peer-session message: cmd=${String(cmd)}, senderId=${senderId}, payload=${JSON.stringify(payload)}`);
+      return;
+    }
     const logContext = `cmd=${cmd}, sessionKey=${data.sessionKey}, sessionId=${data.sessionUuid}, ` + `action=${String(data.action)}, senderId=${senderId}, keepAlive=${!!data.keepAlive}`;
     this.logger.info(`[PeerSession] received peer message: ${logContext}, payload=${JSON.stringify(data.payload ?? {})}`);
     if (cmd === '1001') {

package/lib/plugins/chat/chatroom.js

@@ -77,17 +77,19 @@ class FcrChatRoomControlImpl {
       this._observable.notifyObservers('onTextMessageReceived', this._scene.sceneId, message);
     }
   };
+  _chatConnectionInternalObserver = {
+    onReconnected: () => {
+      this.logger.info('chat connector reconnected, try to rejoin chat room');
+      this._tryJoinChatRoom(true);
+    }
+  };
   _chatConnectionObserver = {
     onConnectionStateUpdated: async connectorState => {
-      const chatRoomConnectionState = this.getConnectionState();
       if (connectorState === _type.FcrChatConnectionState.DISCONNECTED) {
         this._setConnectionState(_type2.FcrChatRoomConnectionState.Disconnected);
-      } else if (connectorState === _type.FcrChatConnectionState.CONNECTED && chatRoomConnectionState !== _type2.FcrChatRoomConnectionState.Connected) {
+      } else if (connectorState === _type.FcrChatConnectionState.CONNECTED) {
         this.logger.info('chat connector connected, try to join chat room');
         this._tryJoinChatRoom();
-      } else if (connectorState === _type.FcrChatConnectionState.CONNECTED) {
-        this.logger.info('chat connector reconnected, try to rejoin chat room');
-        this._tryJoinChatRoom(true);
       }
     }
   };
@@ -202,6 +204,7 @@ class FcrChatRoomControlImpl {
   }
   leave() {
     this._chatConnection.removeObserver(this._chatConnectionObserver);
+    this._chatConnection.removeInternalObserver(this._chatConnectionInternalObserver);
     if (this._connectionState === _type2.FcrChatRoomConnectionState.Disconnected && !this._abortJoinChatRoom) {
       return;
     }
@@ -234,6 +237,7 @@ class FcrChatRoomControlImpl {
   }
   async join(force = false) {
     this._chatConnection.addObserver(this._chatConnectionObserver);
+    this._chatConnection.addInternalObserver(this._chatConnectionInternalObserver);
     const connectorState = this._chatConnection.getConnectionState();
     if (connectorState !== _type.FcrChatConnectionState.CONNECTED) {
       return _type3.FcrReturnCode.SUCCESS;

package/lib/plugins/chat/connector.d.ts

@@ -1,13 +1,15 @@
 import { EasemobChat } from '../../imports';
 import { FcrCoreServiceApi } from '../../service/api';
-import { FcrChatConnectionObserver, FcrChatConnectionState, FcrChatConnector } from '../../chat-connector/type';
-export declare class FcrChatConnectorImpl implements FcrChatConnector {
+import { FcrChatConnectionObserver, FcrChatConnectionState } from '../../chat-connector/type';
+import { FcrChatConnectionInternalObserver, FcrChatConnectorInternal } from './type';
+export declare class FcrChatConnectorImpl implements FcrChatConnectorInternal {
     private _userId;
     private _api;
     private _chatIpList?;
     private _restIpList?;
     protected logger: import("agora-foundation/lib/logger/type").Logger;
     private _observable;
+    private _internalObservable;
     private _initConfig?;
     private _loginPromise;
     private _logoutPromise;
@@ -24,6 +26,8 @@ export declare class FcrChatConnectorImpl implements FcrChatConnector {
     getConnectionInstance(): EasemobChat.Connection;
     addObserver(observer: FcrChatConnectionObserver): void;
     removeObserver(observer: FcrChatConnectionObserver): void;
+    addInternalObserver(observer: FcrChatConnectionInternalObserver): void;
+    removeInternalObserver(observer: FcrChatConnectionInternalObserver): void;
     private _performLogin;
     private _addEventListeners;
     private _performLogout;

package/lib/plugins/chat/connector.js

@@ -43,6 +43,7 @@ class FcrChatConnectorImpl {
     prefix: 'FcrChatConnectorImpl'
   }));
   _observable = new _imports.AgoraObservable();
+  _internalObservable = new _imports.AgoraObservable();
   _loginPromise = null;
   _logoutPromise = null;
   _isLogoutRequested = false;
@@ -98,6 +99,12 @@ class FcrChatConnectorImpl {
   removeObserver(observer) {
     this._observable.removeObserver(observer);
   }
+  addInternalObserver(observer) {
+    this._internalObservable.addObserver(observer);
+  }
+  removeInternalObserver(observer) {
+    this._internalObservable.removeObserver(observer);
+  }
   async _performLogin() {
     const privateConfig = this._getPrivateConfig();
     if (privateConfig) {
@@ -227,7 +234,6 @@ class FcrChatConnectorImpl {
       if (this._restIpList?.length) {
         privateConfig.apiUrl = this._restIpList[0];
       }
-      privateConfig.url = 'wss://apaas-private-im.agoralab.co:13003/websocket';
       return privateConfig;
     }
   }
@@ -235,12 +241,11 @@ class FcrChatConnectorImpl {
     if (this._isLogoutRequested) {
       return;
     }
-    if (this._connectionState !== _type2.FcrChatConnectionState.CONNECTED) {
-      this._setConnectionState(_type2.FcrChatConnectionState.CONNECTED);
-    } else {
-      // notify again in case of reconnection
-      this._observable.notifyObservers('onConnectionStateUpdated', _type2.FcrChatConnectionState.CONNECTED);
+    if (this._connectionState === _type2.FcrChatConnectionState.CONNECTED) {
+      this._internalObservable.notifyObservers('onReconnected');
+      return;
     }
+    this._setConnectionState(_type2.FcrChatConnectionState.CONNECTED);
   }
   _handleDisconnected() {
     if (this._connectionState !== _type2.FcrChatConnectionState.DISCONNECTED) {

package/lib/plugins/chat/type.d.ts

@@ -0,0 +1,8 @@
+import { FcrChatConnector } from '../../chat-connector/type';
+export interface FcrChatConnectorInternal extends FcrChatConnector {
+    addInternalObserver(observer: FcrChatConnectionInternalObserver): void;
+    removeInternalObserver(observer: FcrChatConnectionInternalObserver): void;
+}
+export interface FcrChatConnectionInternalObserver {
+    onReconnected(): void;
+}

package/lib/plugins/chat/type.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/remote-control/index.js

@@ -78,6 +78,10 @@ class FcrRemoteControlImpl {
       data,
       cmd
     } = payload;
+    if (cmd !== '1001' && cmd !== '1002' || !data || typeof data.sessionKey !== 'string' || typeof data.sessionUuid !== 'string') {
+      this.logger.info(`[RemoteControl] ignore non remote-control message: cmd=${String(cmd)}, senderId=${senderId}, payload=${JSON.stringify(payload)}`);
+      return;
+    }
     const logContext = `cmd=${cmd}, sessionKey=${data.sessionKey}, sessionId=${data.sessionUuid}, ` + `action=${String(data.action)}, senderId=${senderId}, keepAlive=${!!data.keepAlive}`;
     if (data.sessionKey !== this._remoteControlSessionKey) {
       this.logger.info(`[RemoteControl] ignore peer message because sessionKey does not match remote-control: ${logContext}`);

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

@@ -8,6 +8,7 @@ export declare enum FcrAbility {
     Caption = "caption",
     Transcribe = "transcribe",
     Recording = "recording",
+    ClientRecording = "clientRecording",
     Board = "board",
     SettingVirtualBackground = "setting:virtualBackground",
     SettingBeautyMode = "setting:beautyMode",

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

@@ -13,6 +13,7 @@ let FcrAbility = exports.FcrAbility = /*#__PURE__*/function (FcrAbility) {
   FcrAbility["Caption"] = "caption";
   FcrAbility["Transcribe"] = "transcribe";
   FcrAbility["Recording"] = "recording";
+  FcrAbility["ClientRecording"] = "clientRecording";
   FcrAbility["Board"] = "board";
   FcrAbility["SettingVirtualBackground"] = "setting:virtualBackground";
   FcrAbility["SettingBeautyMode"] = "setting:beautyMode";

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() {