游戏引擎 / 系统课时
通过事件更新生命值显示
通过事件更新生命值显示
角色受击后,生命条应立即缩短;治疗、复活或重新打开 HUD 时,数值也必须准确。本课在 Unity 6 的 uGUI 界面中,让生命值组件发送变化事件,HUD 只负责显示,并通过明确的订阅与退订时机避免重复刷新。
学习目标
- 让生命值组件只在数值确实改变时发布
HealthChanged。 - 将当前值与最大值转换成 Slider 进度和生命值文本,包含首次显示与复活。
- 验证 HUD 开关和玩家对象替换后,事件不会重复订阅。
划清生命值与 HUD 的职责
以最大生命值 100 为例:受击 30 点后,组件保存 70;它广播 (70, 100),HUD 将滑条设为 0.70,文本设为 70/100。治疗 15 点后显示 85/100,复活后重新显示 100/100。
生命值组件是唯一数据源,负责扣血、治疗、边界限制和发布事件;HUD 不直接改生命值,也不在 Update() 中每帧读取。HUD 第一次启用时还需要主动读取一次当前值,因为初始化不一定产生变化事件。

实现只在变化时通知的事件源
新建 Assets/Scripts/PlayerHealth.cs,挂到玩家根对象。这个最小示例使用整数生命值;-1 只是尚未初始化的内部标记,使 HUD 即便在其他组件的 Awake() 之前读取,也能得到满血快照。
using System;
using UnityEngine;
public sealed class PlayerHealth : MonoBehaviour
{
[SerializeField, Min(1)] private int maxHealth = 100;
private int currentHealth = -1;
public int MaxHealth => Mathf.Max(1, maxHealth);
public int CurrentHealth => currentHealth < 0 ? MaxHealth : currentHealth;
public event Action<int, int> HealthChanged;
private void Awake()
{
// 其他组件提早查询时仍能得到正确初值。
currentHealth = CurrentHealth;
}
private void SetHealth(int next)
{
next = Mathf.Clamp(next, 0, MaxHealth);
if (next == CurrentHealth) return; // 数值未变,不广播。
currentHealth = next;
HealthChanged?.Invoke(currentHealth, MaxHealth);
}
public void TakeDamage(int damage)
{
if (damage <= 0 || CurrentHealth == 0) return;
SetHealth(CurrentHealth - damage);
}
public void Heal(int amount)
{
if (amount <= 0 || CurrentHealth == 0) return;
// 限制增量,避免大数相加溢出。
SetHealth(CurrentHealth + Mathf.Min(amount, MaxHealth - CurrentHealth));
}
public void Revive() => SetHealth(MaxHealth);
[ContextMenu("Test Damage 30")]
private void TestDamage() => TakeDamage(30);
[ContextMenu("Test Heal 15")]
private void TestHeal() => Heal(15);
[ContextMenu("Test Revive")]
private void TestRevive() => Revive();
}预期结果:在 Play 模式通过组件右上角菜单依次执行 Test Damage 30、Test Heal 15 和 Test Revive,内部生命值依次变为 70、85、100;每次真实变化发布一次事件。生命值为 0 时普通治疗无效,只能通过 Revive() 恢复。测试菜单不会自行输出 Console 日志,下一步绑定 HUD 后可观察变化。
订阅事件并绘制生命条
新建 Assets/Scripts/HealthHud.cs。OnEnable() 负责绑定事件并立即渲染当前快照;OnDisable() 解除绑定。Bind() 还支持角色死亡后被销毁并重新实例化的情况,先退订旧对象,再订阅新对象,不会累积委托。
using TMPro;
using UnityEngine;
using UnityEngine.UI;
public sealed class HealthHud : MonoBehaviour
{
[SerializeField] private PlayerHealth health;
[SerializeField] private Slider bar;
[SerializeField] private TMP_Text label;
[SerializeField] private bool logEvents;
private void Awake()
{
if (bar == null) return;
bar.minValue = 0f;
bar.maxValue = 1f;
bar.wholeNumbers = false;
bar.interactable = false;
}
private void OnEnable()
{
Bind(health);
}
public void Bind(PlayerHealth next)
{
// 重绑同一对象或切换对象前,先移除旧监听。
if (isActiveAndEnabled && health != null)
health.HealthChanged -= OnHealthChanged;
health = next;
if (!isActiveAndEnabled) return;
if (health == null || bar == null || label == null)
{
Debug.LogError("HealthHud: 未绑定 health/bar/label", this);
return;
}
health.HealthChanged += OnHealthChanged;
Refresh(health.CurrentHealth, health.MaxHealth);
}
private void OnDisable()
{
if (health != null)
health.HealthChanged -= OnHealthChanged;
}
private void OnHealthChanged(int current, int max)
{
if (logEvents)
Debug.Log($"HealthHud event: {current}/{max}", this);
Refresh(current, max);
}
private void Refresh(int current, int max)
{
// 进度用 0~1 比例,文本保留原始血量。
bar.value = max > 0 ? Mathf.Clamp01((float)current / max) : 0f;
label.text = $"{current}/{max}";
}
}预期结果:HUD 启用即显示当前生命值,不必等第一次受击;每次生命值变化只更新一次 Slider 和文本。勾选 Log Events 后,一次受击 30 点在 Console 中只出现一条 HealthHud event: 70/100,初次读取快照不会打印这条事件日志。
在场景中连接并逐项验收
适用 Unity 6(6000.x)、uGUI 与 TextMeshPro。若项目尚未创建 Canvas,可在 Hierarchy 中通过 GameObject > UI > Canvas 创建;所有 Inspector 引用都应拖入场景中的组件,而不是脚本资源文件。
- 选择玩家根对象,添加
PlayerHealth,设置Max Health = 100。 - 在 Canvas 下创建
UI > Slider,命名HealthBar;将其Min Value设为0、Max Value设为1,关闭Whole Numbers与Interactable。保留 Fill 区域作为进度显示。 - 在 Canvas 下创建
UI > Text - TextMeshPro,命名HealthText;首次使用时按提示导入 TMP Essentials。 - 创建 Canvas 子对象
HealthHUD并挂HealthHud;将玩家的PlayerHealth、HealthBar的Slider和HealthText的 TMP 组件拖入Health、Bar、Label字段。 - 进入 Play 模式,选中玩家的
PlayerHealth组件,打开组件菜单,调用三个测试命令;必要时勾选Log Events统计实际事件次数。
| 操作 | 文本 | Slider Value |
|---|---|---|
| 首次显示 | 100/100 |
1.00 |
| Test Damage 30 | 70/100 |
0.70 |
| Test Heal 15 | 85/100 |
0.85 |
| Test Revive | 100/100 |
1.00 |
再将 HealthHUD 对象停用,在此期间对玩家扣血 30 点,然后重新启用。预期会立刻显示 70/100:停用时未接收事件,恢复时靠主动读取快照追上了真实状态。
排查重复回调和复活不同步
如果一次扣血在 Console 中出现两条相同的 HealthHud event,先确认场景里是不是放了两个启用中的 HealthHud,再检查其他脚本有无额外执行 HealthChanged +=。不要在每次打开背包或每帧 Update() 中重复订阅;应始终成对使用 OnEnable() 和 OnDisable()。
如果复活采用原玩家对象,调用 Revive() 即可;如果销毁旧玩家并创建了新玩家,生成新角色后需调用 HealthHud.Bind(newPlayerHealth)。单纯把新玩家摆进场景不会自动更新序列化的 Health 引用。若绑定对象为空,Console 会出现代码中的缺失引用提示,先处理引用再查事件。