游戏客户端架构 / 系统课时

一个 System 怎样选中实体

一个 System 怎样选中实体

本课把“更新会移动的实体”落实为一个明确的查询:只选出同时拥有 Position 与 Velocity 的实体,再逐个更新位置。你将通过一份可运行的最小 ECS 数据,理解 System 如何确定处理范围,并验证哪些实体会被选中。

学习目标

  • 理解 System 如何根据组件组合筛选实体,而不是根据实体名称或类型判断。
  • 能够编写最小组件查询,并用查询结果驱动位置更新。
  • 能够区分查询匹配、组件读取和状态写回三个环节。

用组件需求定义查询

在 ECS 中,Entity 主要提供身份,Component 保存数据,System 负责处理符合条件的实体。一个 MovementSystem 想要更新位置,需要读取 Velocity,并写回 Position。因此,它最基本的查询条件就是实体必须同时拥有这两个组件。

假设世界中有四个实体:

Entity 拥有的组件 是否命中
101 玩家 Position、Velocity、Health 是
102 石块 Position 否
103 子弹 Position、Velocity 是
104 速度记录对象 Velocity 否

Entity 101 虽然额外拥有 Health,但这不会影响匹配。Entity 102 缺少 Velocity,Entity 104 缺少 Position,因此都不能进入 MovementSystem 的更新集合。

这里的关键规则是:查询要求的所有组件都必须存在,但实体可以拥有更多未被查询要求的组件。

MovementSystem 按 Position 与 Velocity 组件交集筛选实体的数据流

这种机制让系统和实体的具体身份解耦。只要新增的实体拥有 Position 与 Velocity,它就能自动进入运动查询;即使实体从玩家变成投射物,MovementSystem 也不需要针对名称增加特殊分支。

让查询结果驱动位置更新

下面使用原生 Python 模拟一个最小 ECS 世界。为了突出查询语义,示例用字典表示实体及其组件,而不是实现完整的 Archetype 或 Chunk 存储。这是教学用的简化实现,不依赖特定 ECS 框架。

python
world = {
    101: {
        "Position": {"x": 1.0},
        "Velocity": {"x": 2.0},
        "Health": {"hp": 100},
    },
    102: {"Position": {"x": 8.0}},
    103: {
        "Position": {"x": 0.0},
        "Velocity": {"x": -4.0},
    },
    104: {"Velocity": {"x": 1.0}},
}


def query(world, required):
    # 只有拥有全部必需组件的实体才会命中。
    return [
        eid
        for eid, components in world.items()
        if required.issubset(components)
    ]


def movement_system(world, dt):
    matched = query(world, {"Position", "Velocity"})

    # 查询只确定处理对象,位置更新由 System 完成。
    for eid in matched:
        components = world[eid]
        position = components["Position"]
        velocity = components["Velocity"]
        position["x"] += velocity["x"] * dt

    return matched


matched = movement_system(world, 0.5)
print("命中:", matched)

for eid in matched:
    print(f"{eid}: x={world[eid]['Position']['x']:.1f}")

预期输出:

text
命中: [101, 103]
101: x=2.0
103: x=-2.0

Entity 101 的位置从 1.0 更新为 2.0,Entity 103 从 0.0 更新为 -2.0。其余实体没有进入循环,因此不会执行位置计算。

这个示例的 dt=0.5 表示一次更新使用的时间步长。实际游戏一般由固定更新循环或调度器提供时间参数,而不是直接把 0.5 写死在运动逻辑中。

本例按照 Python 字典的插入顺序输出实体 ID,但真实 ECS 查询通常不应依赖实体的遍历顺序。如果处理逻辑需要稳定顺序,应该显式排序或定义独立的顺序规则。

查询、读取和写回不是同一件事

虽然这三个环节经常连续执行,但它们承担不同职责。

查询阶段根据组件是否存在确定候选实体。例如 Query(Position, Velocity) 表达的是组件组合要求,并不关心 Position 中的 x 值,也不会主动计算移动。

读取阶段取得命中实体的组件数据。由于查询已经保证 Position 与 Velocity 同时存在,System 可以在这些实体上安全地读取所需字段,但仍需要保证组件数据本身符合预期格式。

写回阶段执行实际业务计算,把新位置存回 Position。如果把业务计算混入查询筛选逻辑,就容易让过滤条件产生副作用,增加缓存、并行调度和调试的难度。

本例每次查询都扫描所有实体,因此对于 E 个实体,筛选成本随实体数量线性增长。实际 ECS 通常利用组件索引、Sparse Set、Archetype 或 Chunk 预先缩小候选范围,避免每个 System 都完整扫描世界。

组件变化如何影响命中结果

当实体新增或移除组件时,查询结果也应该随之变化。例如给 Entity 102 增加 Velocity,它就满足运动查询;从 Entity 103 移除 Velocity,它就不应继续参与更新。

这类增删组件的操作通常属于结构变化。在采用 Archetype 或 Chunk 的 ECS 中,结构变化可能引起实体迁移、存储重排或查询视图失效,因此不宜在遍历命中集合时随意修改组件组合。更稳妥的做法是在允许的同步点集中应用结构修改。

可以用以下两项检查验证自己的理解:

  1. 把 Entity 103 的 Velocity 移除,再执行查询,预期只命中 Entity 101。
  2. 给 Entity 102 增加 Velocity,再执行查询,预期命中 Entity 101、102 和 103,前提是保留 Entity 103 原有组件。

如果实体明明拥有全部必需组件却没有命中,应优先检查查询条件、组件注册状态及结构变更是否已经生效,而不是先修改 System 的运算公式。

System 选择实体的本质,是根据当前组件组合定义数据处理集合。把组件条件设计准确,后续才能可靠地批量迭代、缓存查询结果,并在适当的执行阶段安全更新组件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

一个 System 怎样选中实体

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通