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

全局总线为什么容易变成垃圾桶

全局总线为什么容易变成垃圾桶

当战斗、背包、界面和存档都向同一个静态事件总线发送消息时,模块看似不再互相引用,却可能共享大量难以追踪的隐式依赖。本篇通过游戏生命值通知的案例,划清直接调用、局部事件域和应用级消息的边界,并实现一套具有明确生命周期的事件通信方案。

学习目标

  • 识别全局单例事件总线被滥用时产生的隐式依赖和生命周期问题。
  • 根据消息的作用范围,选择模块接口、局部事件域或应用级事件。
  • 使用 C# 实现可注入、可订阅和可清理的局部事件域。

全局总线失控的信号

事件总线的原始价值,是让消息发布者不必知道所有订阅者。例如角色受到伤害后,生命值系统可以发布 HealthChanged,由 HUD、音效和战斗日志分别处理。

问题出现在所有模块都开始依赖同一个 GlobalEventBus.Instance。背包操作、UI 按钮点击、任务判断、网络状态和场景切换都通过全局广播完成,事件总线便逐渐成为任何模块都能读写的公共通信空间。

这种设计通常出现以下信号:

  • 事件含义模糊:多个模块共用 DataChanged、Refresh 等宽泛事件,订阅者必须通过额外字段猜测发生了什么。
  • 依赖难以发现:修改一次事件载荷,可能影响多个场景中互不相关的订阅者,编译器也无法发现全部行为依赖。
  • 生命周期混乱:短生命周期的界面订阅长期存在的总线,界面关闭后仍可能被回调。
  • 执行顺序被误用:某个系统依赖另一个订阅者先完成状态修改,却没有显式调用关系和顺序契约。
  • 测试难以隔离:测试必须清理全局订阅者和共享状态,否则前一个测试可能改变后一个测试的结果。

从消息的受众决定事件域

设计通信方式时,先判断消息由谁产生、谁需要处理,以及这些对象是否具有相同的生命周期。不要先建立一个全局总线,再让所有系统向它注册。

游戏客户端局部事件域与应用级事件域的责任边界

可以把通信需求分成三类:

通信需求 推荐方式 判断依据
需要立即执行操作并获得结果 模块接口 调用者需要返回值、错误信息或明确的执行结果
同一场景内多个模块响应状态变化 局部事件域 发布者和订阅者属于同一业务场景或功能作用域
多个场景都需要感知应用级状态变化 应用级事件 消息的意义和生命周期确实超越单个场景

例如,角色使用道具需要确认物品是否存在、数量是否足够,以及是否成功扣除库存。这是需要明确结果的操作,应调用背包服务接口,而不是发布 UseItemRequested 后假设某个订阅者会完成处理。

角色生命值已经改变,则属于既成事实,适合向当前战斗场景发布 HealthChanged。如果游戏语言发生改变,跨场景常驻的设置界面也需要更新,可以使用应用级 LocaleChanged 通知。

核心原则是让事件域的生命周期不超过它实际需要服务的业务范围。同一事件名称在两个相互隔离的场景中使用,并不意味着它们必须共享订阅者。

用实例事件域代替万能单例

下面使用 C# 实现两个独立事件域:BattleEvents 服务当前战斗,AppEvents 服务应用级语言设置。战斗 HUD 通过构造函数获得局部事件域实例,并在释放时解除订阅。

准备安装 .NET 8 或更新版本的 SDK,在终端执行 dotnet new console -n EventScopeDemo 创建控制台项目,将 Program.cs 替换为以下完整代码。

csharp
using System;

var appEvents = new AppEvents();
var battleEvents = new BattleEvents();

using var hud = new BattleHud(battleEvents);
var health = new HealthSystem(battleEvents);

appEvents.LocaleChanged += locale =>
    Console.WriteLine($"App locale: {locale}");

health.TakeDamage(25);
appEvents.ChangeLocale("zh-CN");

public sealed class BattleEvents
{
    public event Action<int>? HealthChanged;

    // 战斗事件只发布当前战斗的生命值变化。
    public void RaiseHealthChanged(int hp) =>
        HealthChanged?.Invoke(hp);
}

public sealed class AppEvents
{
    public event Action<string>? LocaleChanged;

    public void ChangeLocale(string locale) =>
        LocaleChanged?.Invoke(locale);
}

public sealed class HealthSystem
{
    private readonly BattleEvents _events;
    private int _hp = 100;

    public HealthSystem(BattleEvents events) => _events = events;

    public void TakeDamage(int amount)
    {
        if (amount < 0)
            throw new ArgumentOutOfRangeException(nameof(amount));

        // 业务状态先更新,再发布已经发生的事实。
        _hp = Math.Max(0, _hp - amount);
        _events.RaiseHealthChanged(_hp);
    }
}

public sealed class BattleHud : IDisposable
{
    private readonly BattleEvents _events;

    public BattleHud(BattleEvents events)
    {
        _events = events;
        _events.HealthChanged += OnHealthChanged;
    }

    private static void OnHealthChanged(int hp) =>
        Console.WriteLine($"HUD HP: {hp}");

    // 作用域结束时移除订阅,避免回调继续引用旧对象。
    public void Dispose() =>
        _events.HealthChanged -= OnHealthChanged;
}

进入 EventScopeDemo 项目目录执行 dotnet run。

预期输出:

text
HUD HP: 75
App locale: zh-CN

第一行来自战斗事件域,第二行来自应用事件域。两者没有共享事件列表,HealthSystem 也不需要引用 HUD。

实际项目中,可以在创建战斗场景或业务会话时构造 BattleEvents,将同一个实例注入场景内的发布者和订阅者。场景结束后,先让订阅者执行清理,再释放整个局部事件域。示例中的 using var hud 就展示了这一清理责任。

需要注意,AppEvents 在这里同样是显式创建的实例,不必写成静态单例。应用根对象或依赖注入容器可以管理它的生命周期,从而让测试使用独立实例。

为全局事件建立准入条件

全局事件不是绝对不能使用,而是需要比局部事件更严格的约束。决定将一个事件提升到应用级之前,检查三个问题:

  1. 是否真的跨作用域:至少存在明确的跨场景或常驻系统订阅需求,而不只是当前实现方便。
  2. 是否表达已经发生的事实:例如语言设置已改变、玩家身份已切换,而不是要求某个未知订阅者执行关键操作。
  3. 谁负责维护契约与清理订阅:事件名称、载荷类型、发布时机和订阅对象的生命周期都必须有明确归属。

应用级事件应使用稳定、具体的名称,例如 LocaleChanged,避免把 ObjectChanged 作为所有模块通用的消息。重要的业务结果不应依赖无人检查的事件处理器完成。

还要区分事件通知与状态查询。事件告诉订阅者发生了什么,但新进入场景的订阅者可能已经错过事件。需要取得当前语言或当前玩家资料时,应向对应服务查询现有状态,而不是期待全局总线重新广播历史消息。

在工程实践中,优先选择明确的模块接口,其次使用场景或功能级事件域,只有经过跨场景需求验证的通知才进入应用级事件域。这样才能让事件系统保持解耦能力,而不是成为隐藏所有依赖的公共垃圾桶。

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

目录与阅读设置

阅读设置

17

记录一个想法

全局总线为什么容易变成垃圾桶

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

登录哪都通