统一的World管理路径

This commit is contained in:
YHH
2025-10-11 15:14:37 +08:00
parent c19b5ae9a7
commit 532a52acfc
5 changed files with 119 additions and 65 deletions

View File

@@ -3,7 +3,10 @@ import { ECSFluentAPI, createECSAPI } from './Core/FluentAPI';
import { Time } from '../Utils/Time';
import { createLogger } from '../Utils/Logger';
import type { IService } from '../Core/ServiceContainer';
import type { IUpdatable } from '../Types/IUpdatable';
import { World } from './World';
import { WorldManager } from './WorldManager';
import { Injectable, Inject, Updatable } from '../Core/DI';
/**
* 单场景管理器
@@ -18,15 +21,13 @@ import { World } from './World';
* - 简单直观的API
* - 支持延迟场景切换
* - 自动管理ECS API
* - 通过依赖注入获取WorldManager的默认World
*
* @example
* ```typescript
* // 初始化Core
* Core.create({ debug: true });
*
* // 创建场景管理器
* const sceneManager = new SceneManager();
*
* // 设置场景
* class GameScene extends Scene {
* initialize() {
@@ -35,21 +36,22 @@ import { World } from './World';
* }
* }
*
* sceneManager.setScene(new GameScene());
* Core.setScene(new GameScene());
*
* // 游戏循环
* function gameLoop(deltaTime: number) {
* Core.update(deltaTime); // 更新全局服务
* sceneManager.update(); // 更新场景
* Core.update(deltaTime); // 自动更新所有服务(包括SceneManager)
* }
*
* // 延迟切换场景(下一帧生效)
* sceneManager.loadScene(new MenuScene());
* Core.loadScene(new MenuScene());
* ```
*/
export class SceneManager implements IService {
@Injectable()
@Updatable(10)
export class SceneManager implements IService, IUpdatable {
/**
* 内部默认World
* 内部默认World(从WorldManager获取)
*/
private _defaultWorld: World;
@@ -78,9 +80,18 @@ export class SceneManager implements IService {
*/
private static readonly DEFAULT_SCENE_ID = '__main__';
constructor() {
this._defaultWorld = new World({ name: '__default__' });
this._defaultWorld.start();
/**
* 构造函数
*
* WorldManager通过依赖注入自动传入
*
* @param worldManager WorldManager实例,用于获取默认World
*/
constructor(
@Inject(WorldManager) worldManager: WorldManager
) {
// 使用WorldManager管理的默认World
this._defaultWorld = worldManager.getDefaultWorld();
}
/**