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

跨场景事件边界怎么划

跨场景事件边界怎么划

击杀、拾取等事件通常只对当前 ECS World 有意义;一旦切换关卡,继续让新场景订阅旧事件,就可能出现悬空实体引用和重复结算。本课用关卡结算链路划清局部事件、全局通知和持久会话服务的职责。

学习目标

  • 根据消费者与生命周期选择事件的传播范围。
  • 将关卡结果转换为不含实体引用的跨场景数据。
  • 在世界卸载前完成交接,并防止重复提交和残留订阅。

按生命周期选择通道

ECS 的 World 是实体、组件和系统的生命周期边界;一个场景不一定只包含一个 World。判断事件是否该跨界,先问发送者和接收者是否属于同一个 World,以及旧 World 销毁后哪些信息仍然有价值。

机制 合适的内容 边界
世界内事件队列 EnemyDefeated、HealthChanged 当前 World 内产生和消费,按约定帧清空
应用级通知 LanguageChanged、登录状态改变 跨场景广播变化,不承担状态保存
SessionService 累计经验、已解锁关卡 独立于关卡 World 存活,提供可读取的状态

不能因为多个场景都需要玩家经验,就把每次击杀发送到全局事件总线。全局总线会延长订阅关系,增加关卡卸载后的回调风险;真正需要保留的是结算后的数值,而非击杀事件本身。

在退出边界交接值快照

正确路径是世界内的 EnemyDefeated 先更新关卡统计,关卡结束时导出 LevelResult(runId, gainedXp),再由场景协调器交给 SessionService 提交。新 World 创建后向服务读取累计经验,并重新建立自己的事件订阅。

局部 World、跨场景结算和持久服务的通信边界

跨界数据应是不可变、可序列化的值对象,只含运行标识、关卡结果等必要字段;不要传递 Entity 句柄、组件引用或订阅回调。应用级通知可以在提交成功后提醒 UI 或场景协调器,但不能代替 SessionService 存储状态。

用最小程序验证一次交接

下面的 Python 3 示例以世界内事件消费者模拟累计经验,再提交到跨世界存活的服务。<ID> 和 <NEXT_ID> 是演示标识;实际运行应为每次关卡生成不同的唯一标识。

python
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}")

预期输出:

text
首次提交=True
重复提交=False
会话经验=20,新世界临时经验=0

这个示例没有实现引擎事件队列,而是验证交接边界与幂等性;接入实际 ECS 时,on_enemy_defeated 由本地事件消费系统调用,finish 由场景退出流程调用。

卸载时需要守住的顺序

  1. 先停止旧 World 的新事件生产,处理已封口的事件队列并生成结果快照。
  2. 由边界协调器提交结果,确认成功后再释放旧 World 的队列、订阅和实体。
  3. 新 World 从服务读取必要状态并重新订阅;迟到的异步回调须校验 World 代际或运行标识。

如果结算需要落盘或服务端确认,应把成功确认纳入第 2 步,而不是先销毁唯一的数据来源。边界越清晰,局部系统越容易独立复用,也不需要让全局事件总线承担所有通信。

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

目录与阅读设置

阅读设置

17

记录一个想法

跨场景事件边界怎么划

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

登录哪都通