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

事件总线什么时候值得引入

事件总线什么时候值得引入

事件总线解决的不是“怎么发事件”,而是“发布者不应该认识所有订阅者”这一类耦合问题。本节会用游戏 HUD 场景划清 UI 局部事件、游戏领域事件和全局事件的边界,并给出可取消订阅的最小实现。

学习目标

  • 判断直接调用、局部回调和事件总线各自适合的范围
  • 设计可订阅、可取消订阅且不会误伤生命周期的事件链路
  • 识别把所有 UI 操作都塞进全局事件总线的常见副作用

先判断事件有没有跨边界

按钮点击、滑块拖动这类事件通常只在当前 View 或组件树内有意义。如果父组件明确知道子组件,直接回调或局部事件最容易追踪,没有必要绕到全局总线。

当事件表达的是“游戏事实”,而且一个发布者可能被多个互不认识的模块消费时,事件总线才开始有价值。例如角色生命值变化后,血条、低血量警告、受伤音效和遥测模块都可能响应,但角色逻辑不应该逐个持有这些对象。

事件范围 典型例子 推荐方式
UI 局部 点击背包关闭按钮、切换页签 直接回调、组件内事件
游戏领域 生命值变化、任务完成、道具获得 领域事件;跨模块时可经事件总线
全局生命周期 场景切换、语言变化、登录状态变化 少量全局事件,总线集中分发

事件总线在 HUD 中的边界

最小实现要把取消订阅一起设计

只提供 Publish 和 Subscribe 还不够。HUD 页面会反复打开、关闭,如果订阅者退出后没有取消订阅,总线仍然持有回调,就可能出现重复响应、对象无法释放或访问已经失效的界面对象。

下面的示例把订阅结果包装成 IDisposable。调用 Dispose 就能解除对应订阅,适合把订阅句柄绑定到界面或系统的生命周期。

csharp
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));
    }
}

预期输出:

text
HealthBar: 80/100
HealthBar: 25/100
LowHealthWarning: ON
LowHealthWarning: ON

生命周期比总线本身更重要

在实际游戏项目里,订阅通常应该和页面、Widget、Presenter 或系统模块的启停保持一致。创建时订阅、销毁时取消是一种做法;如果对象会频繁隐藏再显示,也可以在启用时订阅、禁用时取消。关键不是固定使用哪个生命周期函数,而是确保同一个有效实例只存在一份订阅。

事件总线也不应承担状态存储。新打开的 HUD 如果必须立即知道当前生命值,应该从状态源读取快照,再订阅后续变化;不能指望“等下一次事件再刷新”。事件表示“发生了什么”,状态表示“现在是什么”。

什么时候不要引入

如果发布者和订阅者本来就处于同一个 UI 模块,而且关系稳定,事件总线只会增加跳转成本。另一个危险信号是大量字符串事件名、无人知道谁在监听、业务流程靠事件连成隐形链路——这时调试会比直接依赖更困难。

值得引入事件总线的条件通常是:事件具有明确语义、确实跨模块、存在一对多订阅需求,并且团队能统一管理订阅生命周期和事件命名。否则,局部回调往往是更简单也更可靠的选择。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件总线什么时候值得引入

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

登录哪都通