场景

在 ECS 架构中，场景（Scene）是游戏世界的容器，负责管理实体、系统和组件的生命周期。场景提供了完整的 ECS 运行环境。

核心功能

场景是 ECS 框架的核心容器，提供：

实体的创建、管理和销毁
系统的注册和执行调度
组件的存储和查询
事件系统支持
性能监控和调试信息

场景管理方式

ECS Framework 提供了两种场景管理方式：

管理器	适用场景	特点
SceneManager	95% 的游戏应用	轻量级，支持场景切换
WorldManager	MMO 服务器、房间系统	多 World 管理，完全隔离

快速开始

继承 Scene 类

import { Scene, EntitySystem } from '@esengine/ecs-framework';

class GameScene extends Scene {
  protected initialize(): void {
    this.name = "GameScene";

    // 添加系统
    this.addSystem(new MovementSystem());
    this.addSystem(new RenderSystem());

    // 创建初始实体
    const player = this.createEntity("Player");
    player.addComponent(new Position(400, 300));
    player.addComponent(new Health(100));
  }

  public onStart(): void {
    console.log("游戏场景已启动");
  }

  public unload(): void {
    console.log("游戏场景已卸载");
  }
}

使用场景配置

import { ISceneConfig } from '@esengine/ecs-framework';

const config: ISceneConfig = {
  name: "MainGame",
  enableEntityDirectUpdate: false
};

class ConfiguredScene extends Scene {
  constructor() {
    super(config);
  }
}

运行时环境

对于网络游戏，你可以配置运行时环境来区分服务端和客户端逻辑。

全局配置（推荐）

在 Core 层级设置一次运行时环境，所有场景都会继承此设置：

import { Core } from '@esengine/ecs-framework';

// 方式1：在 Core.create() 中设置
Core.create({ runtimeEnvironment: 'server' });

// 方式2：直接设置静态属性
Core.runtimeEnvironment = 'server';

单个场景覆盖

个别场景可以覆盖全局设置：

const clientScene = new Scene({ runtimeEnvironment: 'client' });

环境类型

环境	使用场景
`'standalone'`	单机游戏（默认）
`'server'`	游戏服务器，权威逻辑
`'client'`	游戏客户端，渲染/输入

在系统中检查环境

class CollectibleSpawnSystem extends EntitySystem {
  private checkCollections(): void {
    // 客户端跳过 - 只有服务端处理权威逻辑
    if (!this.scene.isServer) return;

    // 服务端权威生成逻辑...
  }
}

参见系统运行时装饰器了解基于装饰器的方式。

运行场景

import { Core, SceneManager } from '@esengine/ecs-framework';

Core.create({ debug: true });
const sceneManager = Core.services.resolve(SceneManager);
sceneManager.setScene(new GameScene());

下一步

生命周期 - 场景生命周期方法
实体管理 - 创建、查找、销毁实体
系统管理 - 系统添加与控制
事件系统 - 场景内事件通信
调试与监控 - 性能分析和调试
最佳实践 - 场景设计模式