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

控制事件生命周期

控制事件生命周期

事件系统真正难点不在于“能触发回调”,而在于监听器何时生效、何时失效,以及对象销毁后是否仍可能被调用。本课将实现一套可注销的监听机制,并用对象析构自动清理订阅,避免悬空引用、重复回调和资源泄漏。

学习目标

  • 理解监听器注册、触发、注销与对象销毁之间的关系
  • 使用订阅标识安全移除回调
  • 验证对象销毁后事件系统不再访问该对象

生命周期中的风险

监听器通常由事件中心长期保存,而监听对象可能提前销毁。若回调捕获了对象指针,却没有在销毁前注销,事件中心下一次派发时就可能访问无效内存。

常见问题包括重复注册导致一次事件执行多次、注销时找不到原回调、遍历监听器时直接删除元素,以及对象已经销毁但回调仍保留在容器中。

监听器从注册到销毁的生命周期流程图

用订阅标识管理监听器

下面的示例为每个监听器分配唯一标识。对象保存该标识,并在析构函数中主动注销。事件派发前先复制当前监听器列表,可避免回调执行期间修改原容器导致迭代器失效。

cpp
#include <cstddef>
#include <functional>
#include <iostream>
#include <unordered_map>
#include <utility>
#include <vector>

class EventBus {
public:
    using ListenerId = std::size_t;
    using Callback = std::function<void(int)>;

    ListenerId subscribe(Callback callback) {
        const ListenerId id = nextId_++;
        listeners_.emplace(id, std::move(callback));
        return id;
    }

    void unsubscribe(ListenerId id) {
        listeners_.erase(id);
    }

    void emit(int value) {
        // 使用快照,允许回调执行过程中安全注销监听器。
        std::vector<Callback> snapshot;
        snapshot.reserve(listeners_.size());
        for (const auto& [id, callback] : listeners_) {
            snapshot.push_back(callback);
        }
        for (const auto& callback : snapshot) {
            callback(value);
        }
    }

private:
    ListenerId nextId_ = 1;
    std::unordered_map<ListenerId, Callback> listeners_;
};

class Player {
public:
    explicit Player(EventBus& bus) : bus_(bus) {
        listenerId_ = bus_.subscribe([this](int damage) {
            health_ -= damage;
            std::cout << "player health: " << health_ << '\n';
        });
    }

    ~Player() {
        // 对象销毁前解除订阅,事件中心不再持有 this。
        bus_.unsubscribe(listenerId_);
    }

private:
    EventBus& bus_;
    EventBus::ListenerId listenerId_{};
    int health_ = 100;
};

int main() {
    EventBus bus;

    {
        Player player(bus);
        bus.emit(30);
    }

    bus.emit(20);
    std::cout << "emit after player destroyed" << '\n';
}

预期输出

text
player health: 70
emit after player destroyed

第二次派发没有输出玩家生命值,说明对象析构时已经移除监听器。若实际输出顺序不同,应检查容器类型或是否存在多个监听器;动态地址、线程编号等运行信息可能因环境而异。

注销与派发的边界

不要用“回调内容相同”来判断是否是同一个监听器,因为闭包对象通常无法可靠比较。使用整数标识或订阅句柄,才能精确注销指定回调。

多线程事件系统还需要为注册、注销和派发建立同步策略。简单做法是在访问容器时加锁,并在释放锁后调用快照中的回调,避免回调再次订阅时发生死锁。

Tips:对象拥有订阅句柄时,应让句柄的生命周期不长于对象。更完整的实现可把句柄封装成 RAII 对象,使其析构时自动注销。

验收检查

运行示例后,先确认对象存活期间事件可以正常触发,再确认对象离开作用域后不会继续收到事件。随后重复创建和销毁对象,检查是否出现重复回调、崩溃或监听器数量持续增长。

本课总结

  • 事件中心通常比监听对象活得更久,因此必须明确注销时机
  • 使用订阅标识或 RAII 句柄可以稳定管理监听器
  • 派发时使用快照,可降低回调修改监听器集合带来的风险

下一课预告

下一课将进入对象与场景系统,从游戏对象的标识、状态和基础生命周期开始建立统一的数据模型。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制事件生命周期

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

登录哪都通