374e08a79e
* feat(profiler): 实现高级性能分析器 * test(core): 添加 ProfilerSDK 和 AdvancedProfilerCollector 测试覆盖 * test(core): 添加 ProfilerSDK 和 AdvancedProfilerCollector 测试覆盖
448 lines
11 KiB
TypeScript
448 lines
11 KiB
TypeScript
import { World, IWorldConfig } from './World';
|
||
import { createLogger } from '../Utils/Logger';
|
||
import type { IService } from '../Core/ServiceContainer';
|
||
|
||
const logger = createLogger('WorldManager');
|
||
|
||
/**
|
||
* WorldManager配置接口
|
||
*/
|
||
export interface IWorldManagerConfig {
|
||
/**
|
||
* 最大World数量
|
||
*/
|
||
maxWorlds?: number;
|
||
|
||
/**
|
||
* 是否自动清理空World
|
||
*/
|
||
autoCleanup?: boolean;
|
||
|
||
/**
|
||
* 清理间隔（帧数）
|
||
*/
|
||
cleanupFrameInterval?: number;
|
||
|
||
/**
|
||
* 是否启用调试模式
|
||
*/
|
||
debug?: boolean;
|
||
}
|
||
|
||
/**
|
||
* World管理器 - 管理所有World实例
|
||
*
|
||
* WorldManager负责管理多个独立的World实例。
|
||
* 每个World都是独立的ECS环境，可以包含多个Scene。
|
||
*
|
||
* 适用场景：
|
||
* - MMO游戏的多房间管理
|
||
* - 服务器端的多游戏实例
|
||
* - 需要完全隔离的多个游戏环境
|
||
*
|
||
* @example
|
||
* ```typescript
|
||
* // 创建WorldManager实例
|
||
* const worldManager = new WorldManager({
|
||
* maxWorlds: 100,
|
||
* autoCleanup: true
|
||
* });
|
||
*
|
||
* // 创建游戏房间World
|
||
* const room1 = worldManager.createWorld('room_001', {
|
||
* name: 'GameRoom_001',
|
||
* maxScenes: 5
|
||
* });
|
||
* room1.setActive(true);
|
||
*
|
||
* // 游戏循环
|
||
* function gameLoop(deltaTime: number) {
|
||
* Core.update(deltaTime);
|
||
* worldManager.updateAll(); // 更新所有活跃World
|
||
* }
|
||
* ```
|
||
*/
|
||
export class WorldManager implements IService {
|
||
private readonly _config: Required<IWorldManagerConfig>;
|
||
private readonly _worlds: Map<string, World> = new Map();
|
||
private _isRunning: boolean = false;
|
||
private _framesSinceCleanup: number = 0;
|
||
|
||
public constructor(config: IWorldManagerConfig = {}) {
|
||
this._config = {
|
||
maxWorlds: 50,
|
||
autoCleanup: true,
|
||
cleanupFrameInterval: 1800, // 1800帧
|
||
debug: false,
|
||
...config
|
||
};
|
||
|
||
// 默认启动运行状态
|
||
this._isRunning = true;
|
||
|
||
logger.info('WorldManager已初始化', {
|
||
maxWorlds: this._config.maxWorlds,
|
||
autoCleanup: this._config.autoCleanup,
|
||
cleanupFrameInterval: this._config.cleanupFrameInterval
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 创建新World
|
||
*/
|
||
public createWorld(worldName: string, config?: IWorldConfig): World {
|
||
if (!worldName || typeof worldName !== 'string' || worldName.trim() === '') {
|
||
throw new Error('World name不能为空');
|
||
}
|
||
|
||
if (this._worlds.has(worldName)) {
|
||
throw new Error(`World name '${worldName}' 已存在`);
|
||
}
|
||
|
||
if (this._worlds.size >= this._config.maxWorlds!) {
|
||
throw new Error(`已达到最大World数量限制: ${this._config.maxWorlds}`);
|
||
}
|
||
|
||
// 优先级：config.debug > WorldManager.debug > 默认
|
||
const worldConfig: IWorldConfig = {
|
||
name: worldName,
|
||
debug: config?.debug ?? this._config.debug ?? false,
|
||
...(config?.maxScenes !== undefined && { maxScenes: config.maxScenes }),
|
||
...(config?.autoCleanup !== undefined && { autoCleanup: config.autoCleanup })
|
||
};
|
||
|
||
const world = new World(worldConfig);
|
||
this._worlds.set(worldName, world);
|
||
|
||
return world;
|
||
}
|
||
|
||
/**
|
||
* 移除World
|
||
*/
|
||
public removeWorld(worldName: string): boolean {
|
||
const world = this._worlds.get(worldName);
|
||
if (!world) {
|
||
return false;
|
||
}
|
||
|
||
// 销毁World
|
||
world.destroy();
|
||
this._worlds.delete(worldName);
|
||
|
||
logger.info(`移除World: ${worldName}`);
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 获取World
|
||
*/
|
||
public getWorld(worldName: string): World | null {
|
||
return this._worlds.get(worldName) || null;
|
||
}
|
||
|
||
/**
|
||
* 获取所有World ID
|
||
*/
|
||
public getWorldIds(): string[] {
|
||
return Array.from(this._worlds.keys());
|
||
}
|
||
|
||
/**
|
||
* 获取所有World
|
||
*/
|
||
public getAllWorlds(): World[] {
|
||
return Array.from(this._worlds.values());
|
||
}
|
||
|
||
/**
|
||
* 设置World激活状态
|
||
*/
|
||
public setWorldActive(worldName: string, active: boolean): void {
|
||
const world = this._worlds.get(worldName);
|
||
if (!world) {
|
||
logger.warn(`World '${worldName}' 不存在`);
|
||
return;
|
||
}
|
||
|
||
if (active) {
|
||
world.start();
|
||
logger.debug(`激活World: ${worldName}`);
|
||
} else {
|
||
world.stop();
|
||
logger.debug(`停用World: ${worldName}`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 检查World是否激活
|
||
*/
|
||
public isWorldActive(worldName: string): boolean {
|
||
const world = this._worlds.get(worldName);
|
||
return world?.isActive ?? false;
|
||
}
|
||
|
||
/**
|
||
* 更新所有活跃的World
|
||
*
|
||
* 应该在每帧的游戏循环中调用。
|
||
* 会自动更新所有活跃World的全局系统和场景。
|
||
*
|
||
* @example
|
||
* ```typescript
|
||
* function gameLoop(deltaTime: number) {
|
||
* Core.update(deltaTime); // 更新全局服务
|
||
* worldManager.updateAll(); // 更新所有World
|
||
* }
|
||
* ```
|
||
*/
|
||
public updateAll(): void {
|
||
if (!this._isRunning) return;
|
||
|
||
for (const world of this._worlds.values()) {
|
||
if (world.isActive) {
|
||
// 更新World的全局System
|
||
world.updateGlobalSystems();
|
||
|
||
// 更新World中的所有Scene
|
||
world.updateScenes();
|
||
}
|
||
}
|
||
|
||
// 基于帧的自动清理
|
||
if (this._config.autoCleanup) {
|
||
this._framesSinceCleanup++;
|
||
|
||
if (this._framesSinceCleanup >= this._config.cleanupFrameInterval) {
|
||
this.cleanup();
|
||
this._framesSinceCleanup = 0; // 重置计数器
|
||
|
||
if (this._config.debug) {
|
||
logger.debug(`执行定期清理World (间隔: ${this._config.cleanupFrameInterval} 帧)`);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取所有激活的World
|
||
*/
|
||
public getActiveWorlds(): World[] {
|
||
const activeWorlds: World[] = [];
|
||
for (const world of this._worlds.values()) {
|
||
if (world.isActive) {
|
||
activeWorlds.push(world);
|
||
}
|
||
}
|
||
return activeWorlds;
|
||
}
|
||
|
||
/**
|
||
* 启动所有World
|
||
*/
|
||
public startAll(): void {
|
||
this._isRunning = true;
|
||
|
||
for (const world of this._worlds.values()) {
|
||
world.start();
|
||
}
|
||
|
||
logger.info('启动所有World');
|
||
}
|
||
|
||
/**
|
||
* 停止所有World
|
||
*/
|
||
public stopAll(): void {
|
||
this._isRunning = false;
|
||
|
||
for (const world of this._worlds.values()) {
|
||
world.stop();
|
||
}
|
||
|
||
logger.info('停止所有World');
|
||
}
|
||
|
||
/**
|
||
* 查找满足条件的World
|
||
*/
|
||
public findWorlds(predicate: (world: World) => boolean): World[] {
|
||
const results: World[] = [];
|
||
for (const world of this._worlds.values()) {
|
||
if (predicate(world)) {
|
||
results.push(world);
|
||
}
|
||
}
|
||
return results;
|
||
}
|
||
|
||
/**
|
||
* 根据名称查找World
|
||
*/
|
||
public findWorldByName(name: string): World | null {
|
||
for (const world of this._worlds.values()) {
|
||
if (world.name === name) {
|
||
return world;
|
||
}
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* 获取WorldManager统计信息
|
||
*/
|
||
public getStats() {
|
||
const stats = {
|
||
totalWorlds: this._worlds.size,
|
||
activeWorlds: this.activeWorldCount,
|
||
totalScenes: 0,
|
||
totalEntities: 0,
|
||
totalSystems: 0,
|
||
memoryUsage: 0,
|
||
isRunning: this._isRunning,
|
||
config: { ...this._config },
|
||
worlds: [] as any[]
|
||
};
|
||
|
||
for (const [worldName, world] of this._worlds) {
|
||
const worldStats = world.getStats();
|
||
stats.totalScenes += worldStats.totalSystems; // World的getStats可能需要调整
|
||
stats.totalEntities += worldStats.totalEntities;
|
||
stats.totalSystems += worldStats.totalSystems;
|
||
|
||
stats.worlds.push({
|
||
id: worldName,
|
||
name: world.name,
|
||
isActive: world.isActive,
|
||
sceneCount: world.sceneCount,
|
||
...worldStats
|
||
});
|
||
}
|
||
|
||
return stats;
|
||
}
|
||
|
||
/**
|
||
* 获取详细状态信息
|
||
*/
|
||
public getDetailedStatus() {
|
||
return {
|
||
...this.getStats(),
|
||
worlds: Array.from(this._worlds.entries()).map(([worldName, world]) => ({
|
||
id: worldName,
|
||
isActive: world.isActive,
|
||
status: world.getStatus()
|
||
}))
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 清理空World
|
||
*/
|
||
public cleanup(): number {
|
||
const worldsToRemove: string[] = [];
|
||
|
||
for (const [worldName, world] of this._worlds) {
|
||
if (this.shouldCleanupWorld(world)) {
|
||
worldsToRemove.push(worldName);
|
||
}
|
||
}
|
||
|
||
for (const worldName of worldsToRemove) {
|
||
this.removeWorld(worldName);
|
||
}
|
||
|
||
if (worldsToRemove.length > 0) {
|
||
logger.debug(`清理了 ${worldsToRemove.length} 个World`);
|
||
}
|
||
|
||
return worldsToRemove.length;
|
||
}
|
||
|
||
/**
|
||
* 销毁WorldManager
|
||
*/
|
||
public destroy(): void {
|
||
logger.info('正在销毁WorldManager...');
|
||
|
||
// 停止所有World
|
||
this.stopAll();
|
||
|
||
// 销毁所有World
|
||
const worldNames = Array.from(this._worlds.keys());
|
||
for (const worldName of worldNames) {
|
||
this.removeWorld(worldName);
|
||
}
|
||
|
||
this._worlds.clear();
|
||
this._isRunning = false;
|
||
|
||
logger.info('WorldManager已销毁');
|
||
}
|
||
|
||
/**
|
||
* 实现 IService 接口的 dispose 方法
|
||
* 调用 destroy 方法进行清理
|
||
*/
|
||
public dispose(): void {
|
||
this.destroy();
|
||
}
|
||
|
||
/**
|
||
* 判断World是否应该被清理
|
||
* 清理策略：
|
||
* 1. World未激活
|
||
* 2. 没有Scene或所有Scene都是空的
|
||
* 3. 创建时间超过10分钟
|
||
*/
|
||
private shouldCleanupWorld(world: World): boolean {
|
||
if (world.isActive) {
|
||
return false;
|
||
}
|
||
|
||
const age = Date.now() - world.createdAt;
|
||
const isOldEnough = age > 10 * 60 * 1000; // 10分钟
|
||
|
||
if (world.sceneCount === 0) {
|
||
return isOldEnough;
|
||
}
|
||
|
||
// 检查是否所有Scene都是空的
|
||
const allScenes = world.getAllScenes();
|
||
const hasEntities = allScenes.some((scene) => scene.entities && scene.entities.count > 0);
|
||
return !hasEntities && isOldEnough;
|
||
}
|
||
|
||
/**
|
||
* 获取World总数
|
||
*/
|
||
public get worldCount(): number {
|
||
return this._worlds.size;
|
||
}
|
||
|
||
/**
|
||
* 获取激活World数量
|
||
*/
|
||
public get activeWorldCount(): number {
|
||
let count = 0;
|
||
for (const world of this._worlds.values()) {
|
||
if (world.isActive) count++;
|
||
}
|
||
return count;
|
||
}
|
||
|
||
/**
|
||
* 检查是否正在运行
|
||
*/
|
||
public get isRunning(): boolean {
|
||
return this._isRunning;
|
||
}
|
||
|
||
/**
|
||
* 获取配置
|
||
*/
|
||
public get config(): IWorldManagerConfig {
|
||
return { ...this._config };
|
||
}
|
||
}
|