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

构建事件分发器

构建事件分发器

本课实现一个最小可运行的事件分发器,让发送者只发布事件、接收者按类型订阅,从而在角色、界面、音效等模块之间传递消息并降低直接依赖。

学习目标

  • 理解发布订阅机制如何降低模块耦合
  • 使用事件类型注册回调并同步分发事件
  • 处理订阅生命周期、执行顺序和递归发布边界

明确事件分发器的职责

事件分发器保存“事件类型到订阅回调列表”的关系。发布者只构造事件并调用 publish,不需要知道谁会处理;订阅者只声明自己关心的事件类型,也不需要知道事件来自哪个模块。

事件发布订阅时序

事件对象应只携带处理所需的数据,不直接执行逻辑。例如受伤事件可以包含剩余生命值和伤害量,界面据此刷新血条,音效系统据此选择反馈,但事件本身不调用界面或音频 API。

实现类型安全的同步分发

下面的 C++17 示例用 std::type_index 区分事件类型,用类型擦除保存不同签名的回调。subscribe<T> 负责注册,publish<T> 按注册顺序同步调用所有订阅者。

cpp
#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});
}

编译并运行:

bash
g++ -std=c++17 main.cpp -o event_demo
./event_demo

预期输出:

text
HUD health: 75
Audio hit, damage: 25
Score: 1200

实际路径可能不同,但同一事件的回调应按注册顺序执行,未订阅的事件应被安全忽略。

选择同步还是队列分发

同步分发实现简单,发布完成前所有回调都会执行,适合本帧必须立即生效的界面刷新或状态通知。但某个回调耗时过长,会直接阻塞发布者;回调中再次发布事件,还可能形成深层递归。

队列分发则先把事件加入队列,在统一更新阶段逐个处理。它更容易控制执行时机和每帧预算,也便于跨线程传递,但事件结果不会立即可见。小型单线程引擎可以先使用同步分发,出现性能、递归或线程边界需求后再引入队列。

管理订阅生命周期

最小示例没有取消订阅功能,生产代码应让 subscribe 返回订阅令牌,并在对象销毁时取消注册。否则回调捕获已经销毁的对象指针后,下一次发布就可能访问无效内存。

分发期间新增或删除订阅者也要制定规则。常见方案是发布时复制回调列表,或把增删操作延迟到本轮分发结束后处理。还应避免把事件总线当作任意全局通信渠道;局部且稳定的一对一依赖,直接调用往往更清楚。

验收低耦合事件链路

验收时可以让角色系统发布 PlayerDamaged,同时由 HUD 和音效系统订阅。移除音效订阅后,角色系统代码不应变化;新增统计模块时,也只需增加订阅者。再发布一个无人订阅的事件,程序应继续运行且不产生错误。

当事件数量增加时,保持事件命名具体、负载精简,并明确事件发生的时点。例如 PlayerHealthChanged 比笼统的 PlayerUpdated 更容易理解,也能减少接收者对额外状态的猜测。

本课总结

  • 事件分发器通过事件类型连接发布者与订阅者,避免模块直接持有彼此
  • 同步分发直观但会继承回调耗时和递归风险,队列分发更适合受控时机
  • 生产实现必须管理取消订阅、对象生命周期和分发期间的结构修改

下一课预告

下一课将把输入系统与事件分发器组合起来,把逻辑操作转换为可订阅的游戏事件,并建立完整的输入处理链路。

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

目录与阅读设置

阅读设置

17

记录一个想法

构建事件分发器

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

登录哪都通