游戏客户端架构 / 系统课时
单帧事件怎么设计
单帧事件怎么设计
一次攻击可能在同一帧产生多条命中记录,音效与统计系统都要读取。如果音效系统先清空缓冲区,统计系统就会漏算。本课实现一个分阶段的事件缓冲区,固定写入、封口、共享读取和帧末清空的顺序,让事件只服务当前更新周期。
学习目标
- 安排单帧事件从创建到失效的明确生命周期。
- 实现写入阶段与只读阶段隔离的最小事件缓冲区。
- 检查多消费者、延迟写入和跨帧残留的边界。
先固定生产和消费顺序
单帧事件是某次更新周期内的短期事实集合,不是让生产者直接调用每个消费者的回调。一个可控的调度顺序如下:
- 开始帧:确认上一个周期已经结束,准备接收新事件。
- 写入:碰撞和伤害系统完成状态修改后,向缓冲区追加事件。
- 封口:所有生产者完成后,把本帧事件固定为只读快照。
- 读取:音效、表现和统计系统独立遍历同一快照,互不删除。
- 结束帧:确认所有消费者已经运行,再统一清空缓冲区。

这个方案要求 ECS 调度器存在明确的写入与读取屏障。若某个生产者排在封口之后,要调整系统顺序,或明确让它写到下一帧的缓冲区;不能悄悄把事件追加到已经公布的快照里。
实现一个带阶段约束的缓冲区
以下 Python 示例把缓冲区限制为 idle、write、read 三个阶段。seal() 返回由不可变事件组成的元组,两个消费者共享这份快照;示例是串行调度模型,不假定列表追加天然支持多线程并发。
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()预期输出:
帧1 音效次数: 2
帧1 统计伤害: 30
帧2 音效次数: 0
帧2 统计伤害: 0帧 1 中两个消费者都读取到两条记录;帧 2 没有生产新事件,因此两项结果都是零。end() 清理的是可写缓冲区,已经返回的元组在 Python 中仍可被外部引用,因此**“不得跨帧持有快照”仍是一项调用约定**,不是这个示例自动强制的内存失效机制。
把时序约束落实到 ECS
首先,把 DamageSystem 等生产者放在事件封口之前,把 SoundSystem、StatsSystem 等消费者放在之后。所有消费者应处理同一事件集合,禁止自行 pop 或清空共享缓冲区。若某个消费者可能被跳过,要明确其事件是否允许丢失,不能默认下帧还能补读。
其次,多线程作业不应同时修改示例中的普通列表。可以让各作业写入各自的局部缓冲区,在写入屏障处合并;如果需要可重现的处理顺序,再按更新序号与事件序号排序。高频事件还应关注容量复用、快照复制和峰值内存。
最后,单帧事件适用于本帧内完成的受击效果与战斗统计通知。跨更新周期的任务、必须确认送达的消息、存档与网络重连,应该使用独立的持久状态、待处理队列或可靠协议,不能指望帧末清空的事件缓冲区保留历史。