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

事件总线需要哪些核心接口

事件总线需要哪些核心接口

当战斗系统需要通知血条、音效和任务模块时,直接调用这些模块的方法会形成复杂的依赖链。本课使用 C# 实现一套最小同步事件总线,明确发布、订阅和取消订阅的职责,并通过实际运行验证事件如何送达处理器。

学习目标

  • 理解 Publish<T>、Subscribe<T> 和 Unsubscribe<T> 的职责与调用关系。
  • 掌握按事件类型组织订阅表的基本方法。
  • 实现并验证一套支持同步分发、重复订阅保护和取消订阅的事件总线。

三个核心接口如何分工

事件总线的核心任务是让发布者与订阅者不必直接持有对方的引用。发布者只负责报告事件,订阅者声明自己关心的事件类型,事件总线负责保存关联关系并执行通知。

最小接口可以设计为以下三个泛型方法:

接口 主要职责 调用时机
Subscribe<T>(Action<T>) 注册某种事件的处理器 模块初始化或启用时
Publish<T>(T) 向对应类型的处理器同步分发事件 业务状态发生变化时
Unsubscribe<T>(Action<T>) 移除先前注册的处理器 模块停用或销毁前

其中,T 表示事件数据类型,Action<T> 表示接收该类型事件的回调委托。订阅者通过回调参数获取事件数据,不需要主动向发布者查询。

例如,角色受到伤害后发布 PlayerDamaged 事件。HUD 和音效模块可以分别订阅它,战斗模块既不用知道订阅者数量,也不用知道具体如何更新界面或播放声音。

Unsubscribe<T> 返回布尔值,可以明确区分成功移除和找不到订阅两种情况。接口本身不负责对象生命周期管理,因此模块必须在适当时机取消订阅。

订阅表在内部怎样组织

事件总线需要解决两个问题:如何快速找到目标处理器,以及如何让同一事件类型对应多个订阅者。

一种简单的数据结构是 Dictionary<Type, List<Delegate>>。字典的键是事件类型 typeof(T),值是该类型对应的处理器列表。发布事件时,先查找类型,再依次调用列表中的委托,而不是遍历所有模块进行判断。

事件总线核心接口与内部订阅表关系

这个结构具有三个重要性质:同一事件类型可以保存多个处理器;不同事件类型相互隔离;未注册处理器的事件可以直接忽略。

取消订阅时,必须使用与注册时相等的委托。尤其要注意,反复创建新的捕获变量的 Lambda 表达式,不能保证得到与原来相等的委托,因此需要保存用于注册的委托实例。

实现一套可运行的事件总线

下面使用 .NET 8 或更新版本创建控制台项目,将代码放入 Program.cs。示例不依赖 Unity 引擎,便于先验证事件总线本身的行为,再将其用于游戏客户端。

csharp
using System;
using System.Collections.Generic;

public interface IEventBus
{
    void Subscribe<T>(Action<T> handler);
    bool Unsubscribe<T>(Action<T> handler);
    void Publish<T>(T message);
}

public sealed class EventBus : IEventBus
{
    // 按事件类型隔离各自的处理器列表
    private readonly Dictionary<Type, List<Delegate>> _handlers = new();

    public void Subscribe<T>(Action<T> handler)
    {
        ArgumentNullException.ThrowIfNull(handler);
        Type key = typeof(T);

        if (!_handlers.TryGetValue(key, out var handlers))
        {
            handlers = new List<Delegate>();
            _handlers.Add(key, handlers);
        }

        // 避免重复注册相等的委托
        if (!handlers.Contains(handler))
            handlers.Add(handler);
    }

    public bool Unsubscribe<T>(Action<T> handler)
    {
        ArgumentNullException.ThrowIfNull(handler);
        Type key = typeof(T);

        if (!_handlers.TryGetValue(key, out var handlers))
            return false;

        bool removed = handlers.Remove(handler);
        if (handlers.Count == 0)
            _handlers.Remove(key);

        return removed;
    }

    public void Publish<T>(T message)
    {
        if (!_handlers.TryGetValue(typeof(T), out var handlers))
            return;

        // 使用快照,允许回调期间修改原始订阅列表
        foreach (Delegate handler in handlers.ToArray())
            ((Action<T>)handler)(message);
    }
}

public readonly record struct PlayerDamaged(int Amount);

public static class Program
{
    public static void Main()
    {
        IEventBus bus = new EventBus();

        // 保存委托实例,以便后续准确取消订阅
        Action<PlayerDamaged> hud = e =>
            Console.WriteLine($"HUD -{e.Amount}");
        Action<PlayerDamaged> sound = e =>
            Console.WriteLine("SFX hit");

        bus.Subscribe(hud);
        bus.Subscribe(sound);
        bus.Publish(new PlayerDamaged(12));

        Console.WriteLine($"Removed: {bus.Unsubscribe(sound)}");
        bus.Publish(new PlayerDamaged(3));
    }
}

在项目目录执行 dotnet run。

预期输出:

text
HUD -12
SFX hit
Removed: True
HUD -3

第一次发布事件时,两个处理器都被调用。音效处理器被移除之后,第二次发布只触发 HUD 更新。Removed: True 说明对应委托已从订阅表中成功删除。

如果再次注册同一个 hud 委托,当前实现不会重复添加它,因此每次发布只会执行一次 HUD 回调。若某事件类型已经没有处理器,其字典条目也会被移除。

同步分发需要明确哪些行为

虽然只用了三个接口,事件总线仍然需要稳定的行为约定,否则业务模块容易对执行顺序、回调异常和生命周期产生错误预期。

  • 同步执行:Publish<T> 在当前调用线程上执行全部回调;正常返回时,本次分发已经结束。
  • 注册顺序:当前实现按处理器加入列表的顺序调用,但业务逻辑不应依赖不同模块之间的隐式顺序。
  • 修改订阅:每次发布先复制处理器列表。回调中新增或取消订阅不会改变本次快照,修改从后续发布开始生效。
  • 异常传播:处理器抛出的异常会向发布者传播,本次尚未执行的回调不会继续运行。
  • 线程约束:普通 Dictionary 和 List 不支持无保护的并发读写,这个实现约定在同一线程中完成订阅与分发。

需要特别注意事件总线通常持有处理器委托,而委托可能引用订阅对象。只要订阅没有解除,对象就可能继续被引用,因此界面关闭、场景切换和组件停用时应执行对应的取消订阅操作。

哪些能力不应过早加入

最小实现已经覆盖了本地事件通知的基本需求,但它并不提供事件持久化、历史消息重放、优先级、异步队列或跨线程安全保证。

如果项目只是让战斗、HUD 和音效等模块交换即时通知,三个接口加一张订阅表通常就足够。只有在确实出现复杂生命周期、严格顺序或性能需求时,才考虑订阅令牌、优先级调度与缓存优化等扩展,避免把事件总线设计成职责不清的全局业务管理器。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件总线需要哪些核心接口

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

登录哪都通