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

加入事件和延迟命令

加入事件和延迟命令

攻击命中可能连续引发扣血、死亡判定、实体销毁和新实体生成。如果系统直接互相调用,查询遍历过程中就可能改变实体集合。本节把跨阶段通知与结构修改分离,搭建一条可验证、可扩展的 ECS 更新链路。

学习目标

  • 区分行为事件、业务请求和实体结构变化命令的职责。
  • 用阶段事件队列与命令缓冲隔离系统,避免查询失效和递归触发。
  • 验证死亡事件只触发一次,并在安全提交点完成生成和销毁。

先切开事件与结构变化

ECS 的 System 应依据组件执行职责明确的批处理,而不是在 AttackSystem 中直接调用 HealthSystem,再由后者调用 SpawnSystem。这类调用会把执行顺序藏进代码,还可能让一次攻击在同一调用栈内反复触发其他逻辑。

事件用于报告已经发生的事实,例如 Hit(target, damage)、Died(entity);SpawnRequest(hp) 则是等待处理的业务请求。事件或请求的载荷只放消费者需要的标识、数据及必要序号,不要直接携带可能在下一阶段失效的组件对象引用。

结构命令用于更改实体组成,例如创建实体、销毁实体、添加或移除组件。对已有 Health 值做扣减不是结构变化,只要 DamageSystem 独占写权限就能在该阶段完成;但新增或删除实体必须先记录到 CommandBuffer,等查询结束再提交。

为跨阶段处理设定封口和屏障

固定步开始时,由战斗系统产出一批命中事件。进入伤害阶段后,消费者读取这批已封口的事件,更新生命值;若生命值首次降到零或以下,就写入下一阶段的死亡事件,并将该实体标记为待死亡,防止同帧后续命中重复发出死亡通知。

生成处理逻辑将 SpawnRequest 转成创建命令,死亡处理逻辑将 Died 转成销毁命令。二者都不立即修改正在遍历的存储。直到所有依赖旧实体集合的查询结束,调度器才执行结构屏障,依次回放命令,并让后续系统读取新实体集合。

ECS 命中事件、死亡处理与结构命令提交的时序

需要明确两种边界:事件封口保证本阶段消费的事件集合不会被回调临时扩张;结构屏障保证查询不会在迭代时遇到实体增删。若消费者又产生事件,将它放进指定的下一阶段队列,避免无界递归分发。

跑通命中、死亡和生成

以下是可用 Python 3 直接运行的最小 ECS 行为模型。health 代表实体的生命值组件表,incoming 是本阶段输入快照,death_events 是下一阶段事件,commands 是待提交的结构操作。把代码保存为 .py 文件后执行即可。

python
from dataclasses import dataclass

@dataclass(frozen=True)
class Hit:
    target: int
    damage: int

@dataclass(frozen=True)
class SpawnRequest:
    hp: int

@dataclass(frozen=True)
class Died:
    entity: int

def main():
    health = {1: 20, 2: 5}
    next_entity_id = 3
    incoming = [Hit(2, 8), Hit(2, 1), SpawnRequest(10)]
    death_events = []
    commands = []
    dying = set()

    # 命中阶段仅修改组件值,不增删实体
    for event in incoming:
        if isinstance(event, Hit):
            if event.target not in health or event.target in dying:
                continue
            health[event.target] -= event.damage
            if health[event.target] <= 0:
                dying.add(event.target)
                death_events.append(Died(event.target))
        elif isinstance(event, SpawnRequest):
            commands.append(("create", event.hp))

    # 死亡阶段只登记销毁命令,实体结构稍后统一改变
    for event in death_events:
        commands.append(("destroy", event.entity))

    print("提交前:", sorted(health))
    for operation, value in commands:
        if operation == "create":
            health[next_entity_id] = value
            next_entity_id += 1
        elif operation == "destroy":
            health.pop(value, None)
    print("提交后:", sorted(health.items()))
    print("死亡事件数:", len(death_events))

if __name__ == "__main__":
    main()

预期输出:

text
提交前: [1, 2]
提交后: [(1, 20), (3, 10)]
死亡事件数: 1

两次命中都指向实体 2,但第一次已使它进入待死亡集合,因此只产生一个死亡事件。结构提交前仍能查询到实体 2;提交后实体 2 被销毁,新实体 3 才进入组件表。这正是事件处理与结构提交分开的可观察证据。

给真实项目补上安全边界

示例用列表表达事件阶段,用二元组表达命令;项目里应为事件定义明确类型、生产阶段和消费阶段,并由调度器统一拥有队列与命令缓冲,而不是让任意系统随时调用 flush()。

还要处理以下容易遗漏的情况:

  • 重复消息:待死亡标记只阻止重复死亡通知,不能替代网络命中的幂等校验。如果同一命中可能重传,应按命中唯一序号去重,否则目标尚未死亡时可能被重复扣血。
  • 过期目标:跨帧事件消费前检查实体仍存在且版本匹配;仅有整数 ID 时,要防止 ID 被回收复用后误伤新实体。
  • 命令冲突:同帧对同一实体既增删组件又销毁时,明确命令合并和优先级;必要时按系统阶段、实体 ID、事件序号稳定排序。
  • 并发生产:多个任务不要无保护地写同一个动态事件列表。每个任务先记录局部事件,再在屏障处按确定顺序合并。

验收时分别构造单次命中、同帧多次命中、目标已销毁和同帧生成四种输入,核对事件数量、提交前后的实体集合及系统读取顺序。只要跨阶段行为只通过事件通信、结构修改只在安全点生效,就能在不增加系统直接依赖的前提下继续扩展战斗逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

加入事件和延迟命令

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

登录哪都通