fcr-core 3.8.1 → 3.9.0-alpha

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

@@ -0,0 +1,92 @@
+/**
+ * 房间控制相关的常量定义
+ */
+
+/**
+ * 通用加入房间常量
+ * room-control 和 room-router 共享的常量
+ */
+export const COMMON_JOIN_CONSTANTS = {
+  /** 加入房间最大重试次数 */
+  MAX_JOIN_ATTEMPTS: 10
+};
+
+/**
+ * 房间控制常量
+ */
+export const ROOM_CONTROL_CONSTANTS = {
+  /** 加入房间最大重试次数 */
+  MAX_JOIN_ATTEMPTS: COMMON_JOIN_CONSTANTS.MAX_JOIN_ATTEMPTS,
+  /** 加入状态 */
+  JOIN_STATE: {
+    CANCELED: 0,
+    JOINING: 1
+  },
+  /** 错误消息 */
+  ERROR_MESSAGES: {
+    NOT_INITIALIZED: 'The controller is not initialized, please add the room first',
+    JOIN_CONFLICT: 'Failed to join the room, the room has been added',
+    JOIN_IN_PROGRESS: 'Failed to join the room, the previous join operation has not been completed yet',
+    JOIN_CANCELED: 'Joining operation has been cancelled'
+  }
+};
+
+/**
+ * 房间消息命令码
+ */
+export const ROOM_MESSAGE_COMMANDS = {
+  /** 房间路由切换命令 */
+  ROOM_ROUTE_SWITCH: 1100,
+  /** 云录制命令 */
+  CLOUD_RECORDING: 1,
+  /** 房间状态更新命令 */
+  ROOM_STATE_UPDATE: 4,
+  /** 房间属性更新命令 */
+  ROOM_PROPERTIES_UPDATE: 8,
+  /** 直播状态更新命令 */
+  LIVE_STREAMING_UPDATE: 700,
+  /** 用户被踢出命令 */
+  USER_KICK_OUT: 5,
+  /** 房间会话请求命令 */
+  ROOM_SESSION_REQUEST: 1001,
+  /** 房间会话接受命令 */
+  ROOM_SESSION_ACCEPT: 1002
+};
+
+/**
+ * 录制状态值
+ */
+export const RECORDING_STATE_VALUES = {
+  /** 录制停止 */
+  STOPPED: 0,
+  /** 录制中 */
+  RECORDING: 1
+};
+
+/**
+ * 直播状态值
+ */
+export const LIVE_STREAMING_STATE_VALUES = {
+  /** 直播停止 */
+  STOPPED: 0,
+  /** 直播开始 */
+  STARTED: 1,
+  /** 直播停止（另一种状态） */
+  STOPPED_ALT: 2
+};
+
+/**
+ * 房间状态值
+ */
+export const ROOM_STATE_VALUES = {
+  /** 房间结束 */
+  ENDED: 3
+};
+
+/**
+ * 响应状态码
+ */
+export const RESPONSE_CODES = {
+  /** 成功 */
+  SUCCESS: 0
+};

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

@@ -0,0 +1,20 @@
+/**
+ * 房间控制辅助工具统一导出
+ *
+ * 提供房间控制相关的所有辅助工具和常量
+ */
+
+// 常量定义
+export * from './constants';
+
+// 验证工具
+export * from './validation-helper';
+
+// 错误处理工具 - 从 utilities 重新导出
+export { FcrErrorHelper, ControllerType, roomControlErrorHelper, engineErrorHelper, liveStreamingErrorHelper, defaultErrorHelper } from '../../utilities/error-helpers';
+
+// 加入相关工具 - 从 utilities 重新导出
+export { handleJoinRetryFailure, FcrJoinHelper } from '../../utilities/join-helper';
+
+// 重试工具 - 从 utilities 重新导出
+export { canRetryJoinError } from '../../utilities/retry-helpers';

package/lib-es/room-control/helpers/validation-helper.js

@@ -0,0 +1,46 @@
+/**
+ * 房间控制验证辅助工具
+ *
+ * 专门处理房间控制相关的验证逻辑
+ */
+
+import { roomControlErrorHelper } from '../../utilities/error-helpers';
+
+/**
+ * 验证控制器是否已初始化
+ * @param controller 控制器实例
+ * @param controllerType 控制器类型
+ * @throws {FcrError} 如果控制器未初始化
+ */
+export function validateControllerInitialized(controller, controllerType) {
+  if (!controller) {
+    throw roomControlErrorHelper.createControllerNotInitializedError(controllerType);
+  }
+}
+
+/**
+ * 验证房间是否已加入
+ * @param joinRoomSuccess 是否已成功加入房间
+ * @param operation 操作名称
+ * @throws {FcrError} 如果房间未加入
+ */
+export function validateRoomJoined(joinRoomSuccess, operation) {
+  if (!joinRoomSuccess) {
+    throw roomControlErrorHelper.createOperationError(`${operation}, please join room first`);
+  }
+}
+
+/**
+ * 验证加入房间的前置条件
+ * @param joinRoomSuccess 是否已成功加入房间
+ * @param joining 是否正在加入
+ * @throws {FcrError} 如果不满足加入条件
+ */
+export function validateJoinRoomPreconditions(joinRoomSuccess, joining) {
+  if (joinRoomSuccess) {
+    throw roomControlErrorHelper.createJoinConflictError(true);
+  }
+  if (joining) {
+    throw roomControlErrorHelper.createJoinConflictError(false);
+  }
+}