游戏客户端架构 / 系统课时
跨场景事件边界怎么划
跨场景事件边界怎么划
击杀、拾取等事件通常只对当前 ECS World 有意义;一旦切换关卡,继续让新场景订阅旧事件,就可能出现悬空实体引用和重复结算。本课用关卡结算链路划清局部事件、全局通知和持久会话服务的职责。
学习目标
- 根据消费者与生命周期选择事件的传播范围。
- 将关卡结果转换为不含实体引用的跨场景数据。
- 在世界卸载前完成交接,并防止重复提交和残留订阅。
按生命周期选择通道
ECS 的 World 是实体、组件和系统的生命周期边界;一个场景不一定只包含一个 World。判断事件是否该跨界,先问发送者和接收者是否属于同一个 World,以及旧 World 销毁后哪些信息仍然有价值。
| 机制 | 合适的内容 | 边界 |
|---|---|---|
| 世界内事件队列 | EnemyDefeated、HealthChanged |
当前 World 内产生和消费,按约定帧清空 |
| 应用级通知 | LanguageChanged、登录状态改变 |
跨场景广播变化,不承担状态保存 |
SessionService |
累计经验、已解锁关卡 | 独立于关卡 World 存活,提供可读取的状态 |
不能因为多个场景都需要玩家经验,就把每次击杀发送到全局事件总线。全局总线会延长订阅关系,增加关卡卸载后的回调风险;真正需要保留的是结算后的数值,而非击杀事件本身。
在退出边界交接值快照
正确路径是世界内的 EnemyDefeated 先更新关卡统计,关卡结束时导出 LevelResult(runId, gainedXp),再由场景协调器交给 SessionService 提交。新 World 创建后向服务读取累计经验,并重新建立自己的事件订阅。

跨界数据应是不可变、可序列化的值对象,只含运行标识、关卡结果等必要字段;不要传递 Entity 句柄、组件引用或订阅回调。应用级通知可以在提交成功后提醒 UI 或场景协调器,但不能代替 SessionService 存储状态。
用最小程序验证一次交接
下面的 Python 3 示例以世界内事件消费者模拟累计经验,再提交到跨世界存活的服务。<ID> 和 <NEXT_ID> 是演示标识;实际运行应为每次关卡生成不同的唯一标识。
from dataclasses import dataclass
@dataclass(frozen=True)
class EnemyDefeated:
xp: int
@dataclass(frozen=True)
class LevelResult:
run_id: str
gained_xp: int
class World:
def __init__(self, run_id: str):
self.run_id = run_id
self.gained_xp = 0
self.active = True
def on_enemy_defeated(self, event: EnemyDefeated):
if not self.active:
raise RuntimeError("世界已关闭")
self.gained_xp += event.xp
def finish(self) -> LevelResult:
if not self.active:
raise RuntimeError("不能重复关闭世界")
self.active = False
return LevelResult(self.run_id, self.gained_xp)
class SessionService:
def __init__(self):
self.total_xp = 0
self.committed: set[str] = set()
def commit(self, result: LevelResult) -> bool:
# 运行标识作为幂等键,防止重试导致双倍奖励。
if result.run_id in self.committed:
return False
self.committed.add(result.run_id)
self.total_xp += result.gained_xp
return True
session = SessionService()
old_world = World("<ID>")
old_world.on_enemy_defeated(EnemyDefeated(20))
result = old_world.finish() # 关闭时导出不含实体引用的值快照。
print(f"首次提交={session.commit(result)}")
print(f"重复提交={session.commit(result)}")
new_world = World("<NEXT_ID>")
print(f"会话经验={session.total_xp},新世界临时经验={new_world.gained_xp}")预期输出:
首次提交=True
重复提交=False
会话经验=20,新世界临时经验=0这个示例没有实现引擎事件队列,而是验证交接边界与幂等性;接入实际 ECS 时,on_enemy_defeated 由本地事件消费系统调用,finish 由场景退出流程调用。
卸载时需要守住的顺序
- 先停止旧 World 的新事件生产,处理已封口的事件队列并生成结果快照。
- 由边界协调器提交结果,确认成功后再释放旧 World 的队列、订阅和实体。
- 新 World 从服务读取必要状态并重新订阅;迟到的异步回调须校验 World 代际或运行标识。
如果结算需要落盘或服务端确认,应把成功确认纳入第 2 步,而不是先销毁唯一的数据来源。边界越清晰,局部系统越容易独立复用,也不需要让全局事件总线承担所有通信。