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

单帧事件怎么设计

单帧事件怎么设计

一次攻击可能在同一帧产生多条命中记录,音效与统计系统都要读取。如果音效系统先清空缓冲区,统计系统就会漏算。本课实现一个分阶段的事件缓冲区,固定写入、封口、共享读取和帧末清空的顺序,让事件只服务当前更新周期。

学习目标

  • 安排单帧事件从创建到失效的明确生命周期。
  • 实现写入阶段与只读阶段隔离的最小事件缓冲区。
  • 检查多消费者、延迟写入和跨帧残留的边界。

先固定生产和消费顺序

单帧事件是某次更新周期内的短期事实集合,不是让生产者直接调用每个消费者的回调。一个可控的调度顺序如下:

  1. 开始帧:确认上一个周期已经结束,准备接收新事件。
  2. 写入:碰撞和伤害系统完成状态修改后,向缓冲区追加事件。
  3. 封口:所有生产者完成后,把本帧事件固定为只读快照。
  4. 读取:音效、表现和统计系统独立遍历同一快照,互不删除。
  5. 结束帧:确认所有消费者已经运行,再统一清空缓冲区。

单帧事件的写入、封口、读取和清空时序

这个方案要求 ECS 调度器存在明确的写入与读取屏障。若某个生产者排在封口之后,要调整系统顺序,或明确让它写到下一帧的缓冲区;不能悄悄把事件追加到已经公布的快照里。

实现一个带阶段约束的缓冲区

以下 Python 示例把缓冲区限制为 idle、write、read 三个阶段。seal() 返回由不可变事件组成的元组,两个消费者共享这份快照;示例是串行调度模型,不假定列表追加天然支持多线程并发。

python
from dataclasses import dataclass

@dataclass(frozen=True)
class DamageEvent:
    entity_id: int
    amount: int

class FrameEventBuffer:
    def __init__(self):
        self._items: list[DamageEvent] = []
        self._phase = "idle"

    def begin(self):
        if self._phase != "idle":
            raise RuntimeError("上一帧尚未结束")
        self._phase = "write"

    def emit(self, event: DamageEvent):
        if self._phase != "write":
            raise RuntimeError("当前阶段不能写事件")
        self._items.append(event)

    def seal(self) -> tuple[DamageEvent, ...]:
        if self._phase != "write":
            raise RuntimeError("只能在写入阶段封口")
        self._phase = "read"
        return tuple(self._items)  # 封口后共享只读快照

    def end(self):
        if self._phase != "read":
            raise RuntimeError("必须先进入读取阶段")
        self._items.clear()  # 所有消费者完成后统一清理
        self._phase = "idle"

buffer = FrameEventBuffer()
for frame in (1, 2):
    buffer.begin()
    if frame == 1:
        # 本帧的两个命中各对应一条事实记录
        buffer.emit(DamageEvent(7, 20))
        buffer.emit(DamageEvent(9, 10))
    current = buffer.seal()
    print(f"帧{frame} 音效次数: {len(current)}")
    print(f"帧{frame} 统计伤害: {sum(e.amount for e in current)}")
    buffer.end()

预期输出:

text
帧1 音效次数: 2
帧1 统计伤害: 30
帧2 音效次数: 0
帧2 统计伤害: 0

帧 1 中两个消费者都读取到两条记录;帧 2 没有生产新事件,因此两项结果都是零。end() 清理的是可写缓冲区,已经返回的元组在 Python 中仍可被外部引用,因此**“不得跨帧持有快照”仍是一项调用约定**,不是这个示例自动强制的内存失效机制。

把时序约束落实到 ECS

首先,把 DamageSystem 等生产者放在事件封口之前,把 SoundSystem、StatsSystem 等消费者放在之后。所有消费者应处理同一事件集合,禁止自行 pop 或清空共享缓冲区。若某个消费者可能被跳过,要明确其事件是否允许丢失,不能默认下帧还能补读。

其次,多线程作业不应同时修改示例中的普通列表。可以让各作业写入各自的局部缓冲区,在写入屏障处合并;如果需要可重现的处理顺序,再按更新序号与事件序号排序。高频事件还应关注容量复用、快照复制和峰值内存。

最后,单帧事件适用于本帧内完成的受击效果与战斗统计通知。跨更新周期的任务、必须确认送达的消息、存档与网络重连,应该使用独立的持久状态、待处理队列或可靠协议,不能指望帧末清空的事件缓冲区保留历史。

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

目录与阅读设置

阅读设置

17

记录一个想法

单帧事件怎么设计

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

登录哪都通