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

用事件解开双向依赖

用事件解开双向依赖

生命值组件如果主动查找 HUD、音效和任务系统,新增一种受伤反馈就得修改生命值逻辑,还可能形成相互引用。本课把生命值变化与死亡变成事件,由订阅者自行处理,并通过可运行示例验证事件顺序、解除订阅和死亡去重。

学习目标

  • 区分发起操作的命令与告知结果的事件。
  • 设计生命值变化和死亡事件的发布、订阅关系。
  • 验证监听者释放后不再收到通知,死亡只发布一次。

从相互调用改为单向通知

ApplyDamage 是一条命令:要求生命值组件执行扣血;HealthChanged 则是已经完成扣血之后公布的事实。HUD 可以刷新显示,音效系统可以播放提示,但生命值组件无须持有这些系统的引用,也不用知道到底有多少订阅者。

如果 HUD 反过来直接驱动扣血、生命值组件又直接刷新 HUD,两个模块会互相认识,初始化与销毁顺序也难以管理。事件把依赖方向固定为“发布者声明事实,订阅者决定反应”,不会把业务规则交给显示层。

组件直接互调与事件单向发布订阅的对比

设计事件与载荷

本例的 HealthChanged 携带变化前后的生命值,订阅者能据此计算进度条比例、变化量或受伤提示,而无须访问发布者的内部字段。Died 只表示“从存活转为死亡”,对已知订阅源的监听者不必重复携带整份角色对象。

事件名应当表示已发生的事实,而不是 UpdateHUD 这样的接收方指令。只发布不可变的必要数据,也能避免监听者持有可变组件引用、在处理时看到与事件发生时不同的状态。若未来改用全局事件总线,再视需要为载荷增加实体标识。

编写并验证事件协作

以下 C# 示例可直接放入 .NET 8 控制台项目的 Program.cs。生命值先完成状态修改,再依次发布变化事件和死亡事件。HUD 被模拟卸载后解除订阅,死亡音效监听者仍可收到自己的通知。

csharp
using System;

public readonly record struct HealthChange(int PreviousHp, int CurrentHp);

public sealed class HealthComponent
{
    private int _hp;

    public event Action<HealthChange>? HealthChanged;
    public event Action? Died;

    public HealthComponent(int hp)
    {
        if (hp <= 0) throw new ArgumentOutOfRangeException(nameof(hp));
        _hp = hp;
    }

    public void ApplyDamage(int amount)
    {
        if (amount < 0) throw new ArgumentOutOfRangeException(nameof(amount));
        if (amount == 0 || _hp == 0) return;

        int before = _hp;
        _hp = Math.Max(0, _hp - amount);

        // 状态先提交,监听者再收到不可变的变化快照
        HealthChanged?.Invoke(new HealthChange(before, _hp));
        if (_hp == 0) Died?.Invoke();
    }
}

public sealed class HealthHud
{
    public void Refresh(HealthChange change) =>
        Console.WriteLine($"HUD:{change.PreviousHp} → {change.CurrentHp}");
}

public sealed class DeathSound
{
    public void OnDied() => Console.WriteLine("音效系统:收到死亡事件");
}

public static class Program
{
    public static void Main()
    {
        var health = new HealthComponent(30);
        var hud = new HealthHud();
        var sound = new DeathSound();

        health.HealthChanged += hud.Refresh;
        health.Died += sound.OnDied;

        health.ApplyDamage(10);
        // 模拟 HUD 卸载,防止长寿命发布者继续持有监听者
        health.HealthChanged -= hud.Refresh;
        health.ApplyDamage(20);
        health.ApplyDamage(5); // 已死亡,不再次触发事件

        health.Died -= sound.OnDied;
    }
}

预期输出:

text
HUD:30 → 20
音效系统:收到死亡事件

第一击触发 HUD 刷新;HUD 取消订阅后,第二击仍会把生命值降到 0 并发布 Died,但不再打印 HUD 消息。第三击因目标已经死亡而直接返回,死亡通知不会重复出现。控制台只模拟收到音效请求,不代表真实播放了音频资源。

管理事件时机与生命周期

本例的 C# event 是同步调用:发布时,订阅处理器会在当前线程依次执行,某个处理器抛出异常可能中断后续分发。因此监听回调应尽量短小,耗时音频加载、资源访问或跨线程 UI 更新应通过专用调度机制处理,不宜直接堵住扣血流程。

发布者通常比临时 HUD 活得更久,事件订阅会持有监听对象的引用。UI 关闭、角色销毁或场景退出时应在相应的生命周期回调中解除订阅;重复进入界面前还要防止重复注册。事件也不是可靠持久队列,后来才订阅的界面应另外读取当前状态,不能期待补收到过去的变化通知。

扩展到拾取与任务协作

拾取系统可以在权限检查、距离验证和物品转移都成功后发布 ItemPickedUp,载荷只包含拾取者、物品标识与数量。任务统计、提示 UI、音效各自订阅,不必让拾取代码逐个调用它们;拾取失败时则不应发出“已经拾取”的事实事件。

判断是否采用事件的关键,是有没有多个彼此独立的后续反应。必须立即得到一个确定结果的操作,例如请求扣血是否成功,仍应使用接口或方法返回值;事实发生后需要广播给不确定数量的观察者,才使用事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

用事件解开双向依赖

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

登录哪都通