Class SceneManager

packages/core/src/ECS/SceneManager.ts:53–308

 * ```
 */
export class SceneManager implements IService {
    /**
     * 内部默认World
     */
    private _defaultWorld: World;

    /**
     * 待切换的下一个场景（延迟切换用）
     */
    private _nextScene: IScene | null = null;

    /**
     * ECS流式API
     */
    private _ecsAPI: ECSFluentAPI | null = null;

    /**
     * 日志器
     */
    private _logger = createLogger('SceneManager');

    /**
     * 场景切换回调函数
     */
    private _onSceneChangedCallback?: () => void;

    /**
     * 性能监控器（从 Core 注入）
     */
    private _performanceMonitor: PerformanceMonitor | null = null;

    /**
     * 待迁移的持久化实体
     *
     * Pending persistent entities for migration.
     */
    private _pendingPersistentEntities: Entity[] = [];

    /**
     * 默认场景ID
     */
    private static readonly DEFAULT_SCENE_ID = '__main__';

    constructor(performanceMonitor?: PerformanceMonitor) {
        this._defaultWorld = new World({ name: '__default__' });
        this._defaultWorld.start();
        this._performanceMonitor = performanceMonitor || null;
    }

    /**
     * 设置场景切换回调
     *
     * @param callback 场景切换时的回调函数
     * @internal
     */
    public setSceneChangedCallback(callback: () => void): void {
        this._onSceneChangedCallback = callback;
    }