游戏引擎 / 系统课时

通过事件更新生命值显示

通过事件更新生命值显示

角色受击后,生命条应立即缩短;治疗、复活或重新打开 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 第一次启用时还需要主动读取一次当前值,因为初始化不一定产生变化事件。

生命值事件源、HUD 更新与订阅生命周期

实现只在变化时通知的事件源

新建 Assets/Scripts/PlayerHealth.cs,挂到玩家根对象。这个最小示例使用整数生命值;-1 只是尚未初始化的内部标记,使 HUD 即便在其他组件的 Awake() 之前读取,也能得到满血快照。

csharp
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() 还支持角色死亡后被销毁并重新实例化的情况,先退订旧对象,再订阅新对象,不会累积委托。

csharp
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 引用都应拖入场景中的组件,而不是脚本资源文件。

  1. 选择玩家根对象,添加 PlayerHealth,设置 Max Health = 100。
  2. 在 Canvas 下创建 UI > Slider,命名 HealthBar;将其 Min Value 设为 0、Max Value 设为 1,关闭 Whole Numbers 与 Interactable。保留 Fill 区域作为进度显示。
  3. 在 Canvas 下创建 UI > Text - TextMeshPro,命名 HealthText;首次使用时按提示导入 TMP Essentials。
  4. 创建 Canvas 子对象 HealthHUD 并挂 HealthHud;将玩家的 PlayerHealth、HealthBar 的 Slider 和 HealthText 的 TMP 组件拖入 Health、Bar、Label 字段。
  5. 进入 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 会出现代码中的缺失引用提示,先处理引用再查事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

通过事件更新生命值显示

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

登录哪都通