Method createScene

packages/core/src/ECS/World.ts:173–203

* @zh 创建并添加Scene到World * @en Create and add Scene to World * * @param sceneName - @zh Scene名称 @en Scene name * @param sceneInstance - @zh Scene实例（可选）@en Scene instance (optional) * @returns @zh 创建的Scene实例 @en Created Scene instance

(sceneName: string, sceneInstance?: T)

     * @returns @zh 创建的Scene实例 @en Created Scene instance
     */
    public createScene<T extends IScene>(sceneName: string, sceneInstance?: T): T {
        if (!sceneName || typeof sceneName !== 'string' || sceneName.trim() === '') {
            throw new Error('Scene name不能为空');
        }

        if (this._scenes.has(sceneName)) {
            throw new Error(`Scene name '${sceneName}' 已存在于World '${this.name}' 中`);
        }

        if (this._scenes.size >= this._config.maxScenes!) {
            throw new Error(`World '${this.name}' 已达到最大Scene数量限制: ${this._config.maxScenes}`);
        }

        const scene = sceneInstance || (new Scene() as unknown as T);

        if (this._config.debug) {
            const performanceMonitor = new PerformanceMonitor();
            performanceMonitor.enable();
            scene.services.registerInstance(PerformanceMonitor, performanceMonitor);
        }

        (scene as { id?: string }).id = sceneName;
        if (!scene.name) {
            scene.name = sceneName;
        }

        this._scenes.set(sceneName, scene);
        scene.initialize();

        return scene;
    }

    /**
     * @zh 移除Scene