fcr-core/lib-es/room-control/room-control-factory.js

Core APIs for building online scenes

import "core-js/modules/esnext.iterator.constructor.js";
import "core-js/modules/esnext.iterator.map.js";
import { DetailErrorCode, ErrorModuleCode, FcrChatRoomControlImpl } from '../imports';
import { convertServerRoomTypeToFcrRoomType } from '../utilities/convertRoomType';
import { generateFcrCoreClientError } from '../utilities/error';
import { FcrInfinityRoomControlImpl } from './infinity-room-control';
import { FcrInterpreterRoomControlImpl } from './interpreter-control/room';
import { FcrJoinBeforeHostWaitingRoomControlImpl } from './join-before-host-waitingroom-control';
import { FcrMainRoomControlImpl } from './mainroom-control';
import { FcrRoomType } from './type';
import { FcrWaitingRoomControlImpl } from './waitingroom-control';

/**
 * 房间控制的创建参数
 */

/**
 * 支持的房间控制类型映射
 */
const ROOM_CONTROL_IMPLEMENTATIONS = {
  [FcrRoomType.Waitingroom]: FcrWaitingRoomControlImpl,
  [FcrRoomType.JoinBeforeHostWaitingRoom]: FcrJoinBeforeHostWaitingRoomControlImpl,
  [FcrRoomType.Mainroom]: FcrMainRoomControlImpl,
  [FcrRoomType.Interpreterroom]: FcrInterpreterRoomControlImpl,
  // 注意：Subroom 目前没有专门的实现类，使用主房间控制
  [FcrRoomType.Subroom]: FcrMainRoomControlImpl,
  [FcrRoomType.Infinityroom]: FcrInfinityRoomControlImpl
};

/**
 * 房间控制工厂类
 * 负责根据房间类型创建相应的房间控制实例
 */
export class RoomControlFactory {
  /**
   * 创建房间控制实例
   * @param params 创建参数
   * @returns 房间控制实例
   * @throws {FcrError} 当房间类型不支持时抛出错误
   */
  static create(params) {
    const {
      engine,
      scene,
      apiService,
      config,
      chatConnection,
      sharedCache,
      roomResponse,
      monitorControl
    } = params;
    const roomType = convertServerRoomTypeToFcrRoomType(roomResponse.room.roomProperties.roomType);
    if (roomType === null) {
      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, `Unsupported room types: ${roomResponse.room.roomProperties.roomType}`);
    }
    const RoomControlImpl = ROOM_CONTROL_IMPLEMENTATIONS[roomType];
    if (!RoomControlImpl) {
      throw generateFcrCoreClientError(ErrorModuleCode.FCR_ROOM, DetailErrorCode.UNDEFINED_ERROR, `Unsupported room types: ${roomType}`);
    }

    // 创建聊天室控制
    const chatRoomControl = new FcrChatRoomControlImpl(scene, chatConnection, sharedCache, false);

    // 创建房间控制实例
    return new RoomControlImpl(engine, scene, apiService, config, sharedCache, chatConnection, chatRoomControl, monitorControl);
  }

  /**
   * 验证房间类型是否受支持
   * @param roomType 房间类型
   * @returns 是否支持
   */
  static isRoomTypeSupported(roomType) {
    return roomType in ROOM_CONTROL_IMPLEMENTATIONS;
  }

  /**
   * 获取所有支持的房间类型
   * @returns 支持的房间类型数组
   */
  static getSupportedRoomTypes() {
    return Object.keys(ROOM_CONTROL_IMPLEMENTATIONS).map(key => parseInt(key, 10));
  }
}