Method setScene

packages/core/src/ECS/SceneManager.ts:131–182

* 设置当前场景（立即切换） * * 会自动处理旧场景的结束和新场景的初始化。 * 持久化实体会自动迁移到新场景。 * * Set current scene (immediate transition). * Automatically handles old scene cleanup and new scene initialization. * Persistent entities are automatically migrated to the new scene. * * @param s

(scene: T)

     * ```
     */
    public setScene<T extends IScene>(scene: T): T {
        // 从当前场景提取持久化实体
        const currentScene = this.currentScene;
        if (currentScene && currentScene instanceof Scene) {
            this._pendingPersistentEntities = currentScene.extractPersistentEntities();
            if (this._pendingPersistentEntities.length > 0) {
                this._logger.debug(
                    `Extracted ${this._pendingPersistentEntities.length} persistent entities for migration`
                );
            }
        }

        // 移除旧场景
        this._defaultWorld.removeAllScenes();

        // 注册全局 PerformanceMonitor 到 Scene 的 ServiceContainer
        if (this._performanceMonitor) {
            scene.services.registerInstance(PerformanceMonitor, this._performanceMonitor);
        }

        // 通过 World 创建新场景
        this._defaultWorld.createScene(SceneManager.DEFAULT_SCENE_ID, scene);
        this._defaultWorld.setSceneActive(SceneManager.DEFAULT_SCENE_ID, true);

        // 迁移持久化实体到新场景
        if (this._pendingPersistentEntities.length > 0 && scene instanceof Scene) {
            scene.receiveMigratedEntities(this._pendingPersistentEntities);
            this._logger.debug(
                `Migrated ${this._pendingPersistentEntities.length} persistent entities to new scene`
            );
            this._pendingPersistentEntities = [];
        }

        // 重建ECS API
        if (scene.querySystem && scene.eventSystem) {
            this._ecsAPI = createECSAPI(scene, scene.querySystem, scene.eventSystem);
        } else {
            this._ecsAPI = null;
        }

        // 触发场景切换回调
        Time.sceneChanged();

        // 通知调试管理器（通过回调）
        if (this._onSceneChangedCallback) {
            this._onSceneChangedCallback();
        }

        this._logger.info(`Scene changed to: ${scene.name}`);

        return scene;
    }

    /**
     * 延迟加载场景（下一帧切换）