fcr-core 3.8.1 → 3.9.0-alpha

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

@@ -0,0 +1,623 @@
+import "core-js/modules/es.array.push.js";
+import "core-js/modules/esnext.function.metadata.js";
+import "core-js/modules/esnext.map.delete-all.js";
+import "core-js/modules/esnext.map.emplace.js";
+import "core-js/modules/esnext.map.every.js";
+import "core-js/modules/esnext.map.filter.js";
+import "core-js/modules/esnext.map.find.js";
+import "core-js/modules/esnext.map.find-key.js";
+import "core-js/modules/esnext.map.includes.js";
+import "core-js/modules/esnext.map.key-of.js";
+import "core-js/modules/esnext.map.map-keys.js";
+import "core-js/modules/esnext.map.map-values.js";
+import "core-js/modules/esnext.map.merge.js";
+import "core-js/modules/esnext.map.reduce.js";
+import "core-js/modules/esnext.map.some.js";
+import "core-js/modules/esnext.map.update.js";
+import "core-js/modules/esnext.symbol.metadata.js";
+let _initProto, _joinDecs, _updateRoomPropertiesDecs, _updateIncrementRoomPropertiesDecs, _deleteRoomPropertiesDecs, _startCloudRecordingDecs, _startLiveStreamingDecs, _updateLiveStreamingLayoutDecs, _sendRoomMessageDecs;
+function _applyDecs(e, t, r, n, o, a) { function i(e, t, r) { return function (n, o) { return r && r(n), e[t].call(n, o); }; } function c(e, t) { for (var r = 0; r < e.length; r++) e[r].call(t); return t; } function s(e, t, r, n) { if ("function" != typeof e && (n || void 0 !== e)) throw new TypeError(t + " must " + (r || "be") + " a function" + (n ? "" : " or undefined")); return e; } function applyDec(e, t, r, n, o, a, c, u, l, f, p, d, h) { function m(e) { if (!h(e)) throw new TypeError("Attempted to access private element on non-instance"); } var y, v = t[0], g = t[3], b = !u; if (!b) { r || Array.isArray(v) || (v = [v]); var w = {}, S = [], A = 3 === o ? "get" : 4 === o || d ? "set" : "value"; f ? (p || d ? w = { get: _setFunctionName(function () { return g(this); }, n, "get"), set: function (e) { t[4](this, e); } } : w[A] = g, p || _setFunctionName(w[A], n, 2 === o ? "" : A)) : p || (w = Object.getOwnPropertyDescriptor(e, n)); } for (var P = e, j = v.length - 1; j >= 0; j -= r ? 2 : 1) { var D = v[j], E = r ? v[j - 1] : void 0, I = {}, O = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: n, metadata: a, addInitializer: function (e, t) { if (e.v) throw Error("attempted to call addInitializer after decoration was finished"); s(t, "An initializer", "be", !0), c.push(t); }.bind(null, I) }; try { if (b) (y = s(D.call(E, P, O), "class decorators", "return")) && (P = y);else { var k, F; O.static = l, O.private = f, f ? 2 === o ? k = function (e) { return m(e), w.value; } : (o < 4 && (k = i(w, "get", m)), 3 !== o && (F = i(w, "set", m))) : (k = function (e) { return e[n]; }, (o < 2 || 4 === o) && (F = function (e, t) { e[n] = t; })); var N = O.access = { has: f ? h.bind() : function (e) { return n in e; } }; if (k && (N.get = k), F && (N.set = F), P = D.call(E, d ? { get: w.get, set: w.set } : w[A], O), d) { if ("object" == typeof P && P) (y = s(P.get, "accessor.get")) && (w.get = y), (y = s(P.set, "accessor.set")) && (w.set = y), (y = s(P.init, "accessor.init")) && S.push(y);else if (void 0 !== P) throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0"); } else s(P, (p ? "field" : "method") + " decorators", "return") && (p ? S.push(P) : w[A] = P); } } finally { I.v = !0; } } return (p || d) && u.push(function (e, t) { for (var r = S.length - 1; r >= 0; r--) t = S[r].call(e, t); return t; }), p || b || (f ? d ? u.push(i(w, "get"), i(w, "set")) : u.push(2 === o ? w[A] : i.call.bind(w[A])) : Object.defineProperty(e, n, w)), P; } function u(e, t) { return Object.defineProperty(e, Symbol.metadata || Symbol.for("Symbol.metadata"), { configurable: !0, enumerable: !0, value: t }); } if (arguments.length >= 6) var l = a[Symbol.metadata || Symbol.for("Symbol.metadata")]; var f = Object.create(null == l ? null : l), p = function (e, t, r, n) { var o, a, i = [], s = function (t) { return _checkInRHS(t) === e; }, u = new Map(); function l(e) { e && i.push(c.bind(null, e)); } for (var f = 0; f < t.length; f++) { var p = t[f]; if (Array.isArray(p)) { var d = p[1], h = p[2], m = p.length > 3, y = 16 & d, v = !!(8 & d), g = 0 == (d &= 7), b = h + "/" + v; if (!g && !m) { var w = u.get(b); if (!0 === w || 3 === w && 4 !== d || 4 === w && 3 !== d) throw Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + h); u.set(b, !(d > 2) || d); } applyDec(v ? e : e.prototype, p, y, m ? "#" + h : _toPropertyKey(h), d, n, v ? a = a || [] : o = o || [], i, v, m, g, 1 === d, v && m ? s : r); } } return l(o), l(a), i; }(e, t, o, f); return r.length || u(e, f), { e: p, get c() { var t = []; return r.length && [u(applyDec(e, [r], n, e.name, 5, f, t), f), c.bind(null, t, e)]; } }; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+// Core SDK imports
+import { AgoraObservable, jsonstring, to, trace } from '../imports';
+
+// Service and API imports
+
+// Type definitions
+import { FcrLiveStreamingLayoutType, FcrLiveStreamingState, FcrRecordingState, FcrReturnCode, FcrUserRole, FcrUserRoleToStringMap } from '../type';
+
+// Room control types and interfaces
+import { FcrRoomType } from './type';
+
+// Control implementations
+import { FcrAbilityControlImpl } from './ability-control';
+import { FcrPrivilegeControlImpl } from './privilege-control';
+import { FcrRoomConnectorControlImpl } from './room-connector-control';
+import { FcrRoomSessionControlImpl } from './room-session';
+import { FcrSharingControlImpl } from './sharing-control';
+import { FcrStreamControlImpl } from './stream-control';
+import { FcrUserControlImpl } from './user-control';
+// Error handling and utilities
+import { ErrorModuleCode } from '../imports';
+import { convertToStructure } from '../utilities/collection';
+import { handleRequestError } from '../utilities/error';
+import { createLogger } from '../utilities/logger';
+
+// Core state
+import { FcrConnectionState } from '..';
+
+// Helpers and utilities
+import { ControllerType } from '../utilities/error-helpers';
+import { FcrJoinHelper, LIVE_STREAMING_STATE_VALUES, liveStreamingErrorHelper, RECORDING_STATE_VALUES, RESPONSE_CODES, ROOM_CONTROL_CONSTANTS, ROOM_MESSAGE_COMMANDS, ROOM_STATE_VALUES, roomControlErrorHelper, validateControllerInitialized, validateJoinRoomPreconditions, validateRoomJoined } from './helpers';
+import { FcrSttControlImpl } from './stt-control';
+/**
+ * 房间控制基础实现类
+ *
+ * 负责管理房间的生命周期，包括加入、离开、状态管理等核心功能。
+ * 提供统一的房间控制接口，管理各个子控制器的初始化和销毁。
+ *
+ * @internal
+ */
+export class FcrBaseRoomControlImpl {
+  static {
+    [_initProto] = _applyDecs(this, [[trace, 2, "getSyncTimestamp"], [trace, 2, "getRoomInfo"], [trace, 2, "getRoomSchedule"], [_joinDecs, 2, "join"], [trace, 2, "leave"], [trace, 2, "start"], [trace, 2, "end"], [trace, 2, "close"], [trace, 2, "getRoomState"], [trace, 2, "getRoomProperties"], [trace, 2, "getRoomPropertiesByKeyPath"], [_updateRoomPropertiesDecs, 2, "updateRoomProperties"], [_updateIncrementRoomPropertiesDecs, 2, "updateIncrementRoomProperties"], [_deleteRoomPropertiesDecs, 2, "deleteRoomProperties"], [_startCloudRecordingDecs, 2, "startCloudRecording"], [trace, 2, "pauseCloudRecording"], [trace, 2, "resumeCloudRecording"], [trace, 2, "stopCloudRecording"], [trace, 2, "getLiveStreamingState"], [trace, 2, "getLiveStreamingConfig"], [_startLiveStreamingDecs, 2, "startLiveStreaming"], [_updateLiveStreamingLayoutDecs, 2, "updateLiveStreamingLayout"], [trace, 2, "stopLiveStreaming"], [trace, 2, "getCloudRecordingState"], [_sendRoomMessageDecs, 2, "sendRoomMessage"]], []).e;
+  }
+  //@internal
+  [(_joinDecs = trace(['options']), _updateRoomPropertiesDecs = trace(['properties', 'cause']), _updateIncrementRoomPropertiesDecs = trace(['increments', 'cause']), _deleteRoomPropertiesDecs = trace(['properties', 'cause']), _startCloudRecordingDecs = trace(['config']), _startLiveStreamingDecs = trace(['data']), _updateLiveStreamingLayoutDecs = trace(['layoutType']), _sendRoomMessageDecs = trace(['payload', 'guaranteedDelivery']), "logger")] = (_initProto(this), createLogger({
+    prefix: 'FcrBaseRoomControlImpl'
+  }));
+  _observable = new AgoraObservable();
+  _joinRoomSuccess = false;
+  _joining = false;
+  _joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+  constructor(_engine, _scene, _api, _config, _roomType, _chatConnection, _sharedCache, _chatRoomControl) {
+    this._engine = _engine;
+    this._scene = _scene;
+    this._api = _api;
+    this._config = _config;
+    this._roomType = _roomType;
+    this._chatConnection = _chatConnection;
+    this._sharedCache = _sharedCache;
+    this._chatRoomControl = _chatRoomControl;
+    // 初始化 FcrJoinHelper
+    const {
+      userId
+    } = this._engine.getConfig();
+    this._joinHelper = new FcrJoinHelper(userId, this._scene, this._api);
+    this._engineObserver = {
+      onConnectionStateUpdated: state => {
+        if (state === FcrConnectionState.ABORTED) {
+          this._joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+          this._cleanup();
+        }
+      }
+    };
+    this._sceneObserver = {
+      onJoinSceneSuccess: (sceneId, localUser) => {
+        this._joinRoomSuccess = true;
+        this._chatRoomControl?.join();
+        this._userControl = new FcrUserControlImpl(this._scene, this._api, this._sharedCache);
+        this._streamControl = new FcrStreamControlImpl(this._engine, this._scene, this._api, this._sharedCache);
+        this._roomSessionControl = new FcrRoomSessionControlImpl(this, this._api, localUser.getLocalUserId());
+        this._privilegeControl = new FcrPrivilegeControlImpl(this._engine, this._scene, this._api, this._sharedCache);
+        this._roomConnectorControl = new FcrRoomConnectorControlImpl(this._scene, this._engine, this._api);
+        this._abilityControl = new FcrAbilityControlImpl(this._scene);
+        if (this._streamControl && !this.sharingControl &&
+        // TODO: 确认是否需要限制在主房间
+        this._roomType === FcrRoomType.Mainroom) {
+          this.logger.info('join scene success, start create sharing control');
+          this.sharingControl = new FcrSharingControlImpl(this._scene, this._api, this._engine, this._privilegeControl, this._streamControl, this._sharedCache, this._userControl);
+        }
+        this._sttControl = new FcrSttControlImpl(this._scene, this._api, this._sharedCache);
+        this._observable.notifyObservers('onJoinRoomSuccess', sceneId);
+      },
+      // onJoinSceneFailure: (sceneId, error) => {
+      //   this._observable.notifyObservers(
+      //     'onJoinRoomFailure',
+      //     sceneId,
+      //     generateFcrCoreClientError(
+      //       ErrorModuleCode.ROOM,
+      //       FcrErrorCode.NOT_JOINED_ROOM,
+      //       'join room failed',
+      //       error,
+      //     ),
+      //   );
+      // },
+      onSceneMessageReceived: (sceneId, message) => {
+        this._observable.notifyObservers('onRoomMessageReceived', sceneId, message);
+        const payload = message.payload;
+        if (message.cmd === ROOM_MESSAGE_COMMANDS.ROOM_ROUTE_SWITCH) {
+          const localUserRole = this._userControl?.getLocalUser().userRole;
+          if (localUserRole && payload.targetRoles.includes(FcrUserRoleToStringMap[localUserRole])) {
+            this._observable.notifyObservers('onRoomRouteSwitched', {
+              targetRouting: {
+                roomId: payload.toRoom.roomUuid,
+                roomType: payload.toRoom.roomType,
+                isJoined: false
+              },
+              operatorUser: this._userControl?.getUser(message.senderId)
+            });
+            this.leave();
+          }
+        }
+      },
+      onScenePropertiesUpdated: async (sceneId, event) => {
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.CLOUD_RECORDING) {
+          const {
+            state,
+            ready,
+            onhold
+          } = this._scene.getSceneProperties().record;
+          const recordState = this._formatRecordingState(state, ready, onhold);
+          this._observable.notifyObservers('onCloudRecordingStateUpdated', sceneId, recordState);
+        }
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.ROOM_STATE_UPDATE) {
+          const schedule = event.changedProperties.schedule;
+          if (schedule.state === ROOM_STATE_VALUES.ENDED) {
+            this._joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+            this._cleanup();
+          }
+          this._observable.notifyObservers('onRoomStateUpdated', sceneId, schedule.state);
+        }
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.ROOM_PROPERTIES_UPDATE) {
+          const changedProperties = {};
+          for (const key in event.changedProperties) {
+            if (key.startsWith('flexProps')) {
+              changedProperties[key] = event.changedProperties[key];
+            }
+          }
+          if (Object.keys(changedProperties).length > 0) {
+            const structure = convertToStructure(changedProperties);
+            this._observable.notifyObservers('onRoomPropertiesUpdated', sceneId, {
+              ...event,
+              changedProperties: structure['flexProps']
+            });
+          }
+        }
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.LIVE_STREAMING_UPDATE) {
+          let liveStreamingState = FcrLiveStreamingState.STOPPED;
+          let state = this._scene.getScenePropertiesByKeyPath('live.state');
+          let pageUrl = this._scene.getScenePropertiesByKeyPath('live.pageUrl');
+          const reason = event.cause?.data?.reason;
+          if (state === LIVE_STREAMING_STATE_VALUES.STARTED) {
+            liveStreamingState = FcrLiveStreamingState.STARTED;
+          }
+          if (state === LIVE_STREAMING_STATE_VALUES.STOPPED_ALT) {
+            liveStreamingState = FcrLiveStreamingState.STOPPED;
+          }
+          this._observable.notifyObservers('onLiveStreamingStateUpdated', sceneId, liveStreamingState, pageUrl, reason);
+        }
+      },
+      onScenePropertiesDeleted: (sceneId, event) => {
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.ROOM_PROPERTIES_UPDATE) {
+          this._observable.notifyObservers('onRoomPropertiesDeleted', sceneId, event);
+        }
+      },
+      onNetworkQualityUpdated: (sceneId, event) => {
+        this._observable.notifyObservers('onNetworkQualityUpdated', sceneId, event);
+      },
+      onNetworkStatsUpdated: (sceneId, stats) => {
+        this._observable.notifyObservers('onNetworkStatsUpdated', sceneId, stats);
+      },
+      onUserPropertiesUpdated: (_, event) => {
+        if (event.cause?.cmd === ROOM_MESSAGE_COMMANDS.USER_KICK_OUT && event.modifiedUser.userId === this._scene.localUser.getLocalUserId()) {
+          this._joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+          this._cleanup();
+        }
+      }
+    };
+  }
+
+  /**
+   * 获取字幕控制器
+   * @returns 字幕控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getSttControl() {
+    validateControllerInitialized(this._sttControl, ControllerType.STT);
+    return this._sttControl;
+  }
+  /**
+   * 获取屏幕共享控制器
+   * @returns 屏幕共享控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getSharingControl() {
+    validateControllerInitialized(this.sharingControl, ControllerType.SHARING);
+    return this.sharingControl;
+  }
+  /**
+   * 获取用户控制器
+   * @returns 用户控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getUserControl() {
+    validateControllerInitialized(this._userControl, ControllerType.USER);
+    return this._userControl;
+  }
+
+  /**
+   * 获取流控制器
+   * @returns 流控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getStreamControl() {
+    validateControllerInitialized(this._streamControl, ControllerType.STREAM);
+    return this._streamControl;
+  }
+
+  /**
+   * 获取房间会话控制器
+   * @returns 房间会话控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getRoomSessionControl() {
+    validateControllerInitialized(this._roomSessionControl, ControllerType.ROOM_SESSION);
+    return this._roomSessionControl;
+  }
+
+  /**
+   * 获取聊天室控制器
+   * @returns 聊天室控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getChatRoomControl() {
+    validateControllerInitialized(this._chatRoomControl, ControllerType.CHAT_ROOM);
+    return this._chatRoomControl;
+  }
+
+  /**
+   * 获取权限控制器
+   * @returns 权限控制器实例
+   * @throws {FcrError} 如果控制器未初始化
+   */
+  // @trace
+  getPrivilegeControl() {
+    validateControllerInitialized(this._privilegeControl, ControllerType.PRIVILEGE);
+    return this._privilegeControl;
+  }
+
+  // @trace
+  getRoomConnectorControl() {
+    validateControllerInitialized(this._roomConnectorControl, ControllerType.ROOM_CONNECTOR);
+    return this._roomConnectorControl;
+  }
+  getAbilityControl() {
+    validateControllerInitialized(this._abilityControl, ControllerType.ABILITY);
+    return this._abilityControl;
+  }
+  getSyncTimestamp() {
+    return this._scene.getSyncTimestamp();
+  }
+
+  /**
+   * 获取房间信息
+   *
+   * @returns 房间信息，如果未加入房间则返回 undefined
+   */
+  getRoomInfo() {
+    const sceneInfo = this._scene.getSceneInfo();
+    const passwordInfo = this._scene.getScenePropertiesByKeyPath('security.password');
+    const userProperties = this._scene.getUserPropertiesByUserId(this._scene.localUser.getLocalUserId());
+    const shareLink = userProperties?.info?.shareLink;
+    const label = this._scene.getScenePropertiesByKeyPath('label');
+    return sceneInfo ? {
+      roomId: sceneInfo.sceneId,
+      roomName: sceneInfo.sceneName,
+      roomType: this._roomType,
+      password: passwordInfo?.payload?.text,
+      inviteLink: shareLink,
+      label
+    } : void 0;
+  }
+
+  /**
+   * 获取房间计划信息
+   *
+   * @returns 房间计划信息，包括开始时间、时长等
+   * @throws {FcrError} 如果未加入房间
+   */
+  getRoomSchedule() {
+    validateRoomJoined(this._joinRoomSuccess, 'get schedule info');
+    const schedule = this._scene.getScenePropertiesByKeyPath('schedule');
+    return {
+      ...schedule,
+      duration: schedule.duration ?? 0,
+      startTime: Math.floor((schedule.startTime ?? 0) / 1000)
+    };
+  }
+  /**
+   * 加入房间
+   *
+   * 支持两种加入方式：
+   * 1. 通过快照加入（适用于已有房间快照的场景）
+   * 2. 通过选项加入（需要进行CheckIn流程）
+   *
+   * @param options 加入房间的选项或快照
+   * @throws {FcrError} 加入失败时抛出错误
+   */
+  async join(options) {
+    // 前置验证和状态设置
+    this._validateAndSetupJoinState();
+    try {
+      this._initializeJoinObservers();
+      await this._executeJoinProcess(options);
+
+      // 处理机器人用户的特殊逻辑
+      await this._handleRobotUserSetup(options);
+      return FcrReturnCode.SUCCESS;
+    } catch (error) {
+      this._cleanup();
+      // 处理加入失败
+      this._handleJoinFailure(error);
+      throw error;
+    } finally {
+      // 清理状态
+      this._joining = false;
+    }
+  }
+
+  /**
+   * 验证前置条件并设置加入状态
+   * @private
+   */
+  _validateAndSetupJoinState() {
+    this._joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.JOINING;
+    validateJoinRoomPreconditions(this._joinRoomSuccess, this._joining);
+  }
+
+  /**
+   * 初始化加入过程的观察者和状态
+   * @private
+   */
+  _initializeJoinObservers() {
+    this._joining = true;
+    this._scene.addObserver(this._sceneObserver);
+    this._engine.addObserver(this._engineObserver);
+  }
+
+  /**
+   * 执行房间加入过程
+   * @private
+   */
+  async _executeJoinProcess(options) {
+    const handleJoinAborted = this._createJoinAbortedHandler();
+    const [error] = await to(this._joinHelper.join(options, handleJoinAborted));
+    if (error) {
+      throw error;
+    }
+  }
+
+  /**
+   * 创建加入中止处理器
+   * @private
+   */
+  _createJoinAbortedHandler() {
+    return () => {
+      if (this._joinState === ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED) {
+        this.logger.info('join is canceled');
+        this._cleanup();
+        const fcrError = roomControlErrorHelper.createOperationCanceledError('Joining');
+        this._observable.notifyObservers('onJoinRoomFailure', this._scene.sceneId, fcrError);
+        throw fcrError;
+      }
+    };
+  }
+
+  /**
+   * 处理机器人用户的特殊设置
+   * @private
+   */
+  async _handleRobotUserSetup(options) {
+    if (options.userRole === FcrUserRole.ROBOT) {
+      const res = handleRequestError(() => this._api.setCloudRecordingReady(this._scene.sceneId), ErrorModuleCode.FCR_ROOM, 'set cloud recording ready failed');
+      this.logger.info(`set cloud recording ready, response: ${jsonstring(res)}`);
+    }
+  }
+
+  /**
+   * 处理加入失败的情况
+   * @private
+   */
+  _handleJoinFailure(error) {
+    this.logger.error(`failed to join room: ${error.message}`);
+    this._observable.notifyObservers('onJoinRoomFailure', this._scene.sceneId, error);
+  }
+
+  /**
+   * 离开房间
+   *
+   * 清理所有资源，包括观察者、控制器实例等
+   */
+  async leave() {
+    this._joinState = ROOM_CONTROL_CONSTANTS.JOIN_STATE.CANCELED;
+    await this._cleanup();
+    return FcrReturnCode.SUCCESS;
+  }
+
+  /**
+   * 开始房间
+   *
+   * 只有房间创建者或管理员才能调用此方法
+   */
+  async start() {
+    await this._api.startRoom(this._scene.sceneId);
+    return FcrReturnCode.SUCCESS;
+  }
+
+  /**
+   * 结束房间
+   *
+   * 只有房间创建者或管理员才能调用此方法
+   */
+  async end() {
+    await this._api.endRoom(this._scene.sceneId);
+    return FcrReturnCode.SUCCESS;
+  }
+  async close() {
+    await this._api.closeRoom(this._scene.sceneId);
+    return FcrReturnCode.SUCCESS;
+  }
+  getRoomState() {
+    return this._scene.getScenePropertiesByKeyPath('schedule.state');
+  }
+  getRoomProperties() {
+    return this._scene.getScenePropertiesByKeyPath('flexProps');
+  }
+  getRoomPropertiesByKeyPath(keyPath) {
+    return this._scene.getScenePropertiesByKeyPath('flexProps.' + keyPath);
+  }
+  async updateRoomProperties(properties, cause) {
+    await handleRequestError(() => this._api.updateRoomProperties({
+      roomId: this._scene.sceneId,
+      properties,
+      cause
+    }), ErrorModuleCode.FCR_ROOM, 'update room properties failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async updateIncrementRoomProperties(increments, cause) {
+    await handleRequestError(() => this._api.updateRoomProperties({
+      roomId: this._scene.sceneId,
+      increments,
+      cause
+    }), ErrorModuleCode.FCR_ROOM, 'update room properties failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async deleteRoomProperties(properties, cause) {
+    await handleRequestError(() => this._api.deleteRoomProperties({
+      roomId: this._scene.sceneId,
+      properties,
+      cause
+    }), ErrorModuleCode.FCR_ROOM, 'delete room rroperties failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async startCloudRecording(config) {
+    await handleRequestError(() => this._api.startCloudRecording(config, this._scene.sceneId), ErrorModuleCode.FCR_ROOM, 'start cloud recording failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async pauseCloudRecording() {
+    await handleRequestError(() => this._api.pauseCloudRecording(this._scene.sceneId), ErrorModuleCode.FCR_ROOM, 'pause cloud recording failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async resumeCloudRecording() {
+    await handleRequestError(() => this._api.resumeCloudRecording(this._scene.sceneId), ErrorModuleCode.FCR_ROOM, 'resume cloud recording failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async stopCloudRecording() {
+    await handleRequestError(() => this._api.stopCloudRecording(this._scene.sceneId), ErrorModuleCode.FCR_ROOM, 'stop cloud recording failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  getLiveStreamingState() {
+    let liveStreamingState = this._scene.getScenePropertiesByKeyPath('live.state');
+    if (liveStreamingState === LIVE_STREAMING_STATE_VALUES.STARTED) {
+      return FcrLiveStreamingState.STARTED;
+    }
+    if (liveStreamingState === LIVE_STREAMING_STATE_VALUES.STOPPED_ALT) {
+      return FcrLiveStreamingState.STOPPED;
+    }
+    return FcrLiveStreamingState.STOPPED;
+  }
+  getLiveStreamingConfig() {
+    const res = this._scene.getScenePropertiesByKeyPath('live');
+    if (res) {
+      return {
+        pushStreamingUrl: res.streamUrl,
+        pullStreamingUrl: res.pageUrl,
+        pushStreamingKey: res.streamKey,
+        layoutType: res.layoutType
+      };
+    }
+    return {
+      pushStreamingUrl: '',
+      pullStreamingUrl: '',
+      pushStreamingKey: '',
+      layoutType: FcrLiveStreamingLayoutType.SPEAKER
+    };
+  }
+  async startLiveStreaming(data) {
+    await this._liveStreamingAction(() => this._api.startLiveStreaming(this._scene.sceneId, data), 'start live streaming failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async updateLiveStreamingLayout(layoutType) {
+    await this._liveStreamingAction(() => this._api.updateLiveStreamingLayout(this._scene.sceneId, layoutType), 'update live streaming layout failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  async stopLiveStreaming() {
+    await this._liveStreamingAction(() => this._api.stopLiveStreaming(this._scene.sceneId), 'stop live streaming failed');
+    return FcrReturnCode.SUCCESS;
+  }
+  getCloudRecordingState() {
+    const {
+      state,
+      ready,
+      onhold
+    } = this._scene.getScenePropertiesByKeyPath('record');
+    return this._formatRecordingState(state, ready, onhold);
+  }
+  async sendRoomMessage(payload, guaranteedDelivery) {
+    try {
+      await this._scene.localUser.sendSceneMessage(payload, '101', guaranteedDelivery);
+      return FcrReturnCode.SUCCESS;
+    } catch (e) {
+      throw roomControlErrorHelper.createSendMessageError(e);
+    }
+  }
+  isHostKeyEnabled() {
+    return this._scene.getScenePropertiesByKeyPath('info.hasHostKey');
+  }
+  addObserver(observer) {
+    this._observable.addObserver(observer);
+  }
+  removeObserver(observer) {
+    this._observable.removeObserver(observer);
+  }
+  async _cleanup() {
+    this._scene.removeObserver(this._sceneObserver);
+    this._engine.removeObserver(this._engineObserver);
+    try {
+      return await Promise.all([this._chatRoomControl?.leave(), this.sharingControl?.getBoardControl().close(), this.sharingControl?.getAnnotationControl().close(), this._scene.leave()]);
+    } finally {
+      this._joinRoomSuccess = false;
+    }
+  }
+  _formatRecordingState(state, ready, onhold) {
+    let recordState = FcrRecordingState.Stopped;
+    if (state === RECORDING_STATE_VALUES.RECORDING) {
+      if (!ready) {
+        recordState = FcrRecordingState.Starting;
+      } else {
+        if (!onhold) {
+          recordState = FcrRecordingState.Started;
+        } else {
+          recordState = FcrRecordingState.Paused;
+        }
+      }
+    }
+    return recordState;
+  }
+  async _liveStreamingAction(action, errorMessage) {
+    try {
+      const {
+        code
+      } = await action();
+      if (code !== RESPONSE_CODES.SUCCESS) {
+        throw liveStreamingErrorHelper.createNetworkError(errorMessage);
+      }
+    } catch (error) {
+      throw liveStreamingErrorHelper.createNetworkError(errorMessage);
+    }
+  }
+}
+/**
+ * @internal
+ */
+export class FcrSubRoomControlImpl extends FcrBaseRoomControlImpl {}