游戏客户端架构 / 系统课时
事件总线什么时候值得引入
事件总线什么时候值得引入
事件总线解决的不是“怎么发事件”,而是“发布者不应该认识所有订阅者”这一类耦合问题。本节会用游戏 HUD 场景划清 UI 局部事件、游戏领域事件和全局事件的边界,并给出可取消订阅的最小实现。
学习目标
- 判断直接调用、局部回调和事件总线各自适合的范围
- 设计可订阅、可取消订阅且不会误伤生命周期的事件链路
- 识别把所有 UI 操作都塞进全局事件总线的常见副作用
先判断事件有没有跨边界
按钮点击、滑块拖动这类事件通常只在当前 View 或组件树内有意义。如果父组件明确知道子组件,直接回调或局部事件最容易追踪,没有必要绕到全局总线。
当事件表达的是“游戏事实”,而且一个发布者可能被多个互不认识的模块消费时,事件总线才开始有价值。例如角色生命值变化后,血条、低血量警告、受伤音效和遥测模块都可能响应,但角色逻辑不应该逐个持有这些对象。
| 事件范围 | 典型例子 | 推荐方式 |
|---|---|---|
| UI 局部 | 点击背包关闭按钮、切换页签 | 直接回调、组件内事件 |
| 游戏领域 | 生命值变化、任务完成、道具获得 | 领域事件;跨模块时可经事件总线 |
| 全局生命周期 | 场景切换、语言变化、登录状态变化 | 少量全局事件,总线集中分发 |

最小实现要把取消订阅一起设计
只提供 Publish 和 Subscribe 还不够。HUD 页面会反复打开、关闭,如果订阅者退出后没有取消订阅,总线仍然持有回调,就可能出现重复响应、对象无法释放或访问已经失效的界面对象。
下面的示例把订阅结果包装成 IDisposable。调用 Dispose 就能解除对应订阅,适合把订阅句柄绑定到界面或系统的生命周期。
using System;
using System.Collections.Generic;
public sealed class EventBus
{
private readonly Dictionary<Type, List<Delegate>> _handlers = new();
public IDisposable Subscribe<T>(Action<T> handler)
{
if (!_handlers.TryGetValue(typeof(T), out var handlers))
{
handlers = new List<Delegate>();
_handlers[typeof(T)] = handlers;
}
handlers.Add(handler);
return new Subscription(() => handlers.Remove(handler));
}
public void Publish<T>(T message)
{
if (!_handlers.TryGetValue(typeof(T), out var handlers))
{
return;
}
// 使用快照,避免回调执行期间取消订阅破坏当前遍历。
foreach (var handler in handlers.ToArray())
{
((Action<T>)handler)(message);
}
}
private sealed class Subscription : IDisposable
{
private Action? _unsubscribe;
public Subscription(Action unsubscribe)
{
_unsubscribe = unsubscribe;
}
public void Dispose()
{
_unsubscribe?.Invoke();
_unsubscribe = null;
}
}
}
public sealed class PlayerHealthChanged
{
public int Current { get; }
public int Max { get; }
public PlayerHealthChanged(int current, int max)
{
Current = current;
Max = max;
}
}
public static class Program
{
public static void Main()
{
var bus = new EventBus();
var healthBarSubscription = bus.Subscribe<PlayerHealthChanged>(e =>
Console.WriteLine($"HealthBar: {e.Current}/{e.Max}"));
using var warningSubscription = bus.Subscribe<PlayerHealthChanged>(e =>
{
if ((double)e.Current / e.Max <= 0.3)
{
Console.WriteLine("LowHealthWarning: ON");
}
});
bus.Publish(new PlayerHealthChanged(80, 100));
bus.Publish(new PlayerHealthChanged(25, 100));
// 血条离开生命周期后解除订阅,后续事件不再触发它。
healthBarSubscription.Dispose();
bus.Publish(new PlayerHealthChanged(20, 100));
}
}预期输出:
HealthBar: 80/100
HealthBar: 25/100
LowHealthWarning: ON
LowHealthWarning: ON生命周期比总线本身更重要
在实际游戏项目里,订阅通常应该和页面、Widget、Presenter 或系统模块的启停保持一致。创建时订阅、销毁时取消是一种做法;如果对象会频繁隐藏再显示,也可以在启用时订阅、禁用时取消。关键不是固定使用哪个生命周期函数,而是确保同一个有效实例只存在一份订阅。
事件总线也不应承担状态存储。新打开的 HUD 如果必须立即知道当前生命值,应该从状态源读取快照,再订阅后续变化;不能指望“等下一次事件再刷新”。事件表示“发生了什么”,状态表示“现在是什么”。
什么时候不要引入
如果发布者和订阅者本来就处于同一个 UI 模块,而且关系稳定,事件总线只会增加跳转成本。另一个危险信号是大量字符串事件名、无人知道谁在监听、业务流程靠事件连成隐形链路——这时调试会比直接依赖更困难。
值得引入事件总线的条件通常是:事件具有明确语义、确实跨模块、存在一对多订阅需求,并且团队能统一管理订阅生命周期和事件命名。否则,局部回调往往是更简单也更可靠的选择。