Method setMode

packages/runtime-core/src/GameRuntime.ts:274–321

* @zh 设置运行模式 * @en Set runtime mode * * @zh 根据模式自动配置系统启用状态、UI 显示等 * @en Automatically configures system enabling, UI visibility, etc. based on mode * * @param mode - @zh 目标模式 @en Target mode * @param options - @zh 可选覆盖配置 @en Optional override configuration

(mode: RuntimeMode, options?: Partial<RuntimeModeConfig>)

     * @param options - @zh 可选覆盖配置 @en Optional override configuration
     */
    setMode(mode: RuntimeMode, options?: Partial<RuntimeModeConfig>): void {
        if (!this._state.initialized) {
            console.warn('[GameRuntime] Cannot set mode before initialization');
            return;
        }

        const previousMode = this._state.mode;
        this._state.mode = mode;

        // 获取模式配置并应用覆盖
        const config = { ...getRuntimeModeConfig(mode), ...options };

        console.log(`[GameRuntime] Mode: ${previousMode} → ${mode}`);

        // 1. 配置场景编辑器模式
        if (this._scene) {
            this._scene.isEditorMode = !config.triggerLifecycle;
        }

        // 2. 配置渲染系统
        if (this._renderSystem) {
            this._renderSystem.setPreviewMode(mode !== RuntimeMode.EditorStatic);
            this._renderSystem.setShowGizmos(config.showGizmos);
        }

        // 3. 配置引擎桥接
        if (this._bridge) {
            this._bridge.setShowGrid(config.showGrid);
            this._bridge.setEditorMode(config.isEditorEnvironment);
        }

        // 4. 配置输入系统
        if (this._inputSystem) {
            this._inputSystem.enabled = config.enableInput;
        }

        // 5. 配置游戏逻辑系统
        this._applySystemConfig(config);

        // 6. 触发生命周期（从静态模式进入其他模式时）
        if (previousMode === RuntimeMode.EditorStatic && config.triggerLifecycle) {
            this._scene?.begin();
        }

        // 7. 更新运行状态
        this._state.running = shouldEnableGameLogic(mode);
        this._state.paused = false;
    }

    /**
     * @zh 应用系统配置