游戏客户端架构 / 系统课时
构建事件分发器
构建事件分发器
本课实现一个最小可运行的事件分发器,让发送者只发布事件、接收者按类型订阅,从而在角色、界面、音效等模块之间传递消息并降低直接依赖。
学习目标
- 理解发布订阅机制如何降低模块耦合
- 使用事件类型注册回调并同步分发事件
- 处理订阅生命周期、执行顺序和递归发布边界
明确事件分发器的职责
事件分发器保存“事件类型到订阅回调列表”的关系。发布者只构造事件并调用 publish,不需要知道谁会处理;订阅者只声明自己关心的事件类型,也不需要知道事件来自哪个模块。

事件对象应只携带处理所需的数据,不直接执行逻辑。例如受伤事件可以包含剩余生命值和伤害量,界面据此刷新血条,音效系统据此选择反馈,但事件本身不调用界面或音频 API。
实现类型安全的同步分发
下面的 C++17 示例用 std::type_index 区分事件类型,用类型擦除保存不同签名的回调。subscribe<T> 负责注册,publish<T> 按注册顺序同步调用所有订阅者。
#include <functional>
#include <iostream>
#include <string>
#include <typeindex>
#include <unordered_map>
#include <utility>
#include <vector>
class EventBus {
public:
template <typename Event>
void subscribe(std::function<void(const Event&)> handler) {
auto wrapper = [handler = std::move(handler)](const void* rawEvent) {
handler(*static_cast<const Event*>(rawEvent));
};
handlers_[std::type_index(typeid(Event))].push_back(std::move(wrapper));
}
template <typename Event>
void publish(const Event& event) const {
auto iterator = handlers_.find(std::type_index(typeid(Event)));
if (iterator == handlers_.end()) {
return;
}
for (const auto& handler : iterator->second) {
handler(&event);
}
}
private:
using ErasedHandler = std::function<void(const void*)>;
std::unordered_map<std::type_index, std::vector<ErasedHandler>> handlers_;
};
struct PlayerDamaged {
int damage;
int healthAfter;
};
struct ScoreChanged {
int totalScore;
};
int main() {
EventBus events;
events.subscribe<PlayerDamaged>([](const PlayerDamaged& event) {
std::cout << "HUD health: " << event.healthAfter << '\n';
});
events.subscribe<PlayerDamaged>([](const PlayerDamaged& event) {
std::cout << "Audio hit, damage: " << event.damage << '\n';
});
events.subscribe<ScoreChanged>([](const ScoreChanged& event) {
std::cout << "Score: " << event.totalScore << '\n';
});
events.publish(PlayerDamaged{25, 75});
events.publish(ScoreChanged{1200});
}编译并运行:
g++ -std=c++17 main.cpp -o event_demo
./event_demo预期输出:
HUD health: 75
Audio hit, damage: 25
Score: 1200实际路径可能不同,但同一事件的回调应按注册顺序执行,未订阅的事件应被安全忽略。
选择同步还是队列分发
同步分发实现简单,发布完成前所有回调都会执行,适合本帧必须立即生效的界面刷新或状态通知。但某个回调耗时过长,会直接阻塞发布者;回调中再次发布事件,还可能形成深层递归。
队列分发则先把事件加入队列,在统一更新阶段逐个处理。它更容易控制执行时机和每帧预算,也便于跨线程传递,但事件结果不会立即可见。小型单线程引擎可以先使用同步分发,出现性能、递归或线程边界需求后再引入队列。
管理订阅生命周期
最小示例没有取消订阅功能,生产代码应让 subscribe 返回订阅令牌,并在对象销毁时取消注册。否则回调捕获已经销毁的对象指针后,下一次发布就可能访问无效内存。
分发期间新增或删除订阅者也要制定规则。常见方案是发布时复制回调列表,或把增删操作延迟到本轮分发结束后处理。还应避免把事件总线当作任意全局通信渠道;局部且稳定的一对一依赖,直接调用往往更清楚。
验收低耦合事件链路
验收时可以让角色系统发布 PlayerDamaged,同时由 HUD 和音效系统订阅。移除音效订阅后,角色系统代码不应变化;新增统计模块时,也只需增加订阅者。再发布一个无人订阅的事件,程序应继续运行且不产生错误。
当事件数量增加时,保持事件命名具体、负载精简,并明确事件发生的时点。例如 PlayerHealthChanged 比笼统的 PlayerUpdated 更容易理解,也能减少接收者对额外状态的猜测。
本课总结
- 事件分发器通过事件类型连接发布者与订阅者,避免模块直接持有彼此
- 同步分发直观但会继承回调耗时和递归风险,队列分发更适合受控时机
- 生产实现必须管理取消订阅、对象生命周期和分发期间的结构修改
下一课预告
下一课将把输入系统与事件分发器组合起来,把逻辑操作转换为可订阅的游戏事件,并建立完整的输入处理链路。