游戏客户端架构 / 系统课时
事件总线需要哪些核心接口
事件总线需要哪些核心接口
当战斗系统需要通知血条、音效和任务模块时,直接调用这些模块的方法会形成复杂的依赖链。本课使用 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 引擎,便于先验证事件总线本身的行为,再将其用于游戏客户端。
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。
预期输出:
HUD -12
SFX hit
Removed: True
HUD -3第一次发布事件时,两个处理器都被调用。音效处理器被移除之后,第二次发布只触发 HUD 更新。Removed: True 说明对应委托已从订阅表中成功删除。
如果再次注册同一个 hud 委托,当前实现不会重复添加它,因此每次发布只会执行一次 HUD 回调。若某事件类型已经没有处理器,其字典条目也会被移除。
同步分发需要明确哪些行为
虽然只用了三个接口,事件总线仍然需要稳定的行为约定,否则业务模块容易对执行顺序、回调异常和生命周期产生错误预期。
- 同步执行:
Publish<T>在当前调用线程上执行全部回调;正常返回时,本次分发已经结束。 - 注册顺序:当前实现按处理器加入列表的顺序调用,但业务逻辑不应依赖不同模块之间的隐式顺序。
- 修改订阅:每次发布先复制处理器列表。回调中新增或取消订阅不会改变本次快照,修改从后续发布开始生效。
- 异常传播:处理器抛出的异常会向发布者传播,本次尚未执行的回调不会继续运行。
- 线程约束:普通
Dictionary和List不支持无保护的并发读写,这个实现约定在同一线程中完成订阅与分发。
需要特别注意事件总线通常持有处理器委托,而委托可能引用订阅对象。只要订阅没有解除,对象就可能继续被引用,因此界面关闭、场景切换和组件停用时应执行对应的取消订阅操作。
哪些能力不应过早加入
最小实现已经覆盖了本地事件通知的基本需求,但它并不提供事件持久化、历史消息重放、优先级、异步队列或跨线程安全保证。
如果项目只是让战斗、HUD 和音效等模块交换即时通知,三个接口加一张订阅表通常就足够。只有在确实出现复杂生命周期、严格顺序或性能需求时,才考虑订阅令牌、优先级调度与缓存优化等扩展,避免把事件总线设计成职责不清的全局业务管理器。