游戏客户端架构 / 系统课时
用事件解开双向依赖
用事件解开双向依赖
生命值组件如果主动查找 HUD、音效和任务系统,新增一种受伤反馈就得修改生命值逻辑,还可能形成相互引用。本课把生命值变化与死亡变成事件,由订阅者自行处理,并通过可运行示例验证事件顺序、解除订阅和死亡去重。
学习目标
- 区分发起操作的命令与告知结果的事件。
- 设计生命值变化和死亡事件的发布、订阅关系。
- 验证监听者释放后不再收到通知,死亡只发布一次。
从相互调用改为单向通知
ApplyDamage 是一条命令:要求生命值组件执行扣血;HealthChanged 则是已经完成扣血之后公布的事实。HUD 可以刷新显示,音效系统可以播放提示,但生命值组件无须持有这些系统的引用,也不用知道到底有多少订阅者。
如果 HUD 反过来直接驱动扣血、生命值组件又直接刷新 HUD,两个模块会互相认识,初始化与销毁顺序也难以管理。事件把依赖方向固定为“发布者声明事实,订阅者决定反应”,不会把业务规则交给显示层。

设计事件与载荷
本例的 HealthChanged 携带变化前后的生命值,订阅者能据此计算进度条比例、变化量或受伤提示,而无须访问发布者的内部字段。Died 只表示“从存活转为死亡”,对已知订阅源的监听者不必重复携带整份角色对象。
事件名应当表示已发生的事实,而不是 UpdateHUD 这样的接收方指令。只发布不可变的必要数据,也能避免监听者持有可变组件引用、在处理时看到与事件发生时不同的状态。若未来改用全局事件总线,再视需要为载荷增加实体标识。
编写并验证事件协作
以下 C# 示例可直接放入 .NET 8 控制台项目的 Program.cs。生命值先完成状态修改,再依次发布变化事件和死亡事件。HUD 被模拟卸载后解除订阅,死亡音效监听者仍可收到自己的通知。
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;
}
}预期输出:
HUD:30 → 20
音效系统:收到死亡事件第一击触发 HUD 刷新;HUD 取消订阅后,第二击仍会把生命值降到 0 并发布 Died,但不再打印 HUD 消息。第三击因目标已经死亡而直接返回,死亡通知不会重复出现。控制台只模拟收到音效请求,不代表真实播放了音频资源。
管理事件时机与生命周期
本例的 C# event 是同步调用:发布时,订阅处理器会在当前线程依次执行,某个处理器抛出异常可能中断后续分发。因此监听回调应尽量短小,耗时音频加载、资源访问或跨线程 UI 更新应通过专用调度机制处理,不宜直接堵住扣血流程。
发布者通常比临时 HUD 活得更久,事件订阅会持有监听对象的引用。UI 关闭、角色销毁或场景退出时应在相应的生命周期回调中解除订阅;重复进入界面前还要防止重复注册。事件也不是可靠持久队列,后来才订阅的界面应另外读取当前状态,不能期待补收到过去的变化通知。
扩展到拾取与任务协作
拾取系统可以在权限检查、距离验证和物品转移都成功后发布 ItemPickedUp,载荷只包含拾取者、物品标识与数量。任务统计、提示 UI、音效各自订阅,不必让拾取代码逐个调用它们;拾取失败时则不应发出“已经拾取”的事实事件。
判断是否采用事件的关键,是有没有多个彼此独立的后续反应。必须立即得到一个确定结果的操作,例如请求扣血是否成功,仍应使用接口或方法返回值;事实发生后需要广播给不确定数量的观察者,才使用事件。