游戏引擎 / 系统课时

同步生命值与状态文本

同步生命值与状态文本

本课把玩家的生命值变化同步到 HUD 的血条、数值文本和状态提示,并让界面只在数值变化或重新启用时刷新。完成后,你可以通过测试按钮验证受伤、治疗、危险血量和生命值归零的显示效果,而不必在每帧重复读取角色状态。

学习目标

  • 将角色生命值作为唯一数据源,避免 UI 保存另一份独立状态。
  • 使用 C# 事件同步血条、生命值文本和状态提示。
  • 正确管理 UI 事件订阅,并验证无效变化不会触发重复刷新。

先把状态与显示解耦

假设玩家最大生命值为 100,受到 20 点伤害后,HUD 应同时显示 80 / 100、80% 的血条以及对应状态。若这三处信息分别读取、计算和维护,很容易在受伤、治疗或界面重新打开时出现不同步。

更稳定的设计是让 PlayerHealth 独占生命值数据。外部逻辑通过 Damage 或 Heal 修改生命值,只有实际数值改变时才发出 HealthChanged 事件。HealthHud 监听事件,把同一份状态转换成不同的视觉表现。

生命值变化事件与 HUD 组件的数据流关系

这里有两个需要明确的职责边界:

  • PlayerHealth 负责当前生命值、最大生命值、数值限制与变化通知,不直接引用血条或文本。
  • HealthHud 只负责读取状态并更新显示,不自行扣血,也不在 Update 中持续轮询生命值。

这样即使以后增加屏幕变红、低血量音效或角色头像变化,也可以由其他监听者响应同一个事件,而不必修改生命值计算逻辑。

在玩家脚本中发出变化事件

在 Unity 项目的 Assets/Scripts 目录创建 PlayerHealth.cs,将它挂到场景中的 Player 对象。最大生命值默认是 100,运行开始时生命值也初始化为 100。

csharp
using System;
using UnityEngine;

public sealed class PlayerHealth : MonoBehaviour
{
    [SerializeField, Min(1)] private int maxHealth = 100;

    public int MaxHealth => maxHealth;
    public int CurrentHealth { get; private set; }
    public event Action<int, int> HealthChanged;

    private void Awake()
    {
        maxHealth = Mathf.Max(1, maxHealth);
        CurrentHealth = maxHealth;
    }

    public void Damage(int amount)
    {
        if (amount > 0)
            SetHealth(CurrentHealth - amount);
    }

    public void Heal(int amount)
    {
        if (amount > 0)
            SetHealth(CurrentHealth + amount);
    }

    private void SetHealth(int next)
    {
        // 限制生命值范围,防止治疗溢出或伤害扣成负数。
        int value = Mathf.Clamp(next, 0, maxHealth);

        // 数值没有变化就不通知 UI,避免无效刷新。
        if (value == CurrentHealth) return;

        CurrentHealth = value;
        HealthChanged?.Invoke(CurrentHealth, maxHealth);
    }
}

这是完整主示例的第一个脚本,需要配合后面的 HealthHud.cs 和场景引用运行。HealthChanged 的两个参数分别是变化后的当前生命值和最大生命值,监听者无需再访问多个变量来拼出一次显示更新。

特别注意 SetHealth 中的相等判断。玩家已经处于 0 生命值时,再次受到伤害不会改变结果,因此不应重复触发 HUD 刷新。同样,满血时继续治疗也不会产生变化事件。

在场景中连接血条与按钮

本例使用 Unity 内置的 uGUI,包括 Canvas、Slider、Text 和 Button。文本控件使用 UnityEngine.UI.Text,在提供分类菜单的 Unity 版本中可通过 UI > Legacy > Text 创建,无须额外引入 TextMeshPro 依赖。

  1. 在场景中创建 Canvas,并在其中创建一个 Slider,命名为 HealthSlider。将 Min Value 设为 0、Max Value 设为 1,并关闭 Interactable,使玩家不能拖动血条直接修改显示值。
  2. 创建两个 Text,分别命名为 HealthText 和 StatusText,用于显示 100 / 100 与 正常。调整文字颜色、字号和位置,确保它们不会相互遮挡。
  3. 在 Canvas 下创建 HealthHud 对象,稍后挂载显示脚本。场景中的 Player 对象已经挂有 PlayerHealth。
  4. 添加两个 Button,文字分别设置为 受伤 20 和 治疗 20。在各自的 On Click() 事件中拖入 Player,分别选择 PlayerHealth.Damage(int) 与 PlayerHealth.Heal(int),静态整数参数均填写 20。

按钮只是测试入口。正式项目中可以由敌人攻击、陷阱或道具逻辑调用相同的生命值方法,不需要改变 HUD 的实现。

订阅事件并显示状态

在 Assets/Scripts 创建 HealthHud.cs,挂到 HealthHud 对象,并在 Inspector 中分别绑定 PlayerHealth、HealthSlider、HealthText 和 StatusText。

csharp
using UnityEngine;
using UnityEngine.UI;

public sealed class HealthHud : MonoBehaviour
{
    [SerializeField] private PlayerHealth playerHealth;
    [SerializeField] private Slider healthSlider;
    [SerializeField] private Text healthText;
    [SerializeField] private Text statusText;

    private bool started;

    private void OnEnable()
    {
        // 界面启用时订阅;重新启用时补齐可能错过的变化。
        playerHealth.HealthChanged += Render;
        if (started)
            Render(playerHealth.CurrentHealth, playerHealth.MaxHealth);
    }

    private void Start()
    {
        // 等所有活跃对象完成 Awake 后再绘制初始生命值。
        started = true;
        Render(playerHealth.CurrentHealth, playerHealth.MaxHealth);
    }

    private void OnDisable()
    {
        playerHealth.HealthChanged -= Render;
    }

    private void Render(int current, int max)
    {
        // 血条采用0到1的比例,文本保留实际生命值。
        healthSlider.SetValueWithoutNotify((float)current / max);
        healthText.text = $"{current} / {max}";

        if (current == 0)
            statusText.text = "已倒下";
        else if (current <= max * 0.3f)
            statusText.text = "危险";
        else
            statusText.text = "正常";
    }
}

预期结果(最大生命值保持默认的 100,依次点击测试按钮):

text
进入场景:100 / 100,正常,血条100%
受伤20:80 / 100,正常,血条80%
再受伤3次:20 / 100,危险,血条20%
再受伤1次:0 / 100,已倒下,血条0%
治疗20:20 / 100,危险,血条20%

以上是 Game 视图应呈现的状态,而不是 Console 自动打印的日志。状态判断优先检查是否归零,再检查危险阈值,避免 0 生命值被错误显示为普通低血量。

SetValueWithoutNotify 可以修改 Slider 数值而不触发它自身的 onValueChanged 监听者,适合这种从游戏状态向界面单向同步的场景。此例没有让 Slider 控制角色生命值,因此不存在 UI 与游戏状态相互回写的问题。

验收与边界处理

运行场景时重点检查三个容易漏掉的场景。

首先,连续点击受伤按钮直到生命值归零,然后继续点击。生命值和文字应停留在 0,不能出现负数,也不应再发出没有实际变化的事件。满血后继续治疗,同样不应产生变化通知。

其次,在剩余 20 点生命值时临时禁用 HealthHud 对象,通过其他保持启用的调用方修改玩家生命值,再重新启用 HUD。界面应读取当前最新值,而不是停留在关闭前的数值。这就是 OnEnable 中重新同步的意义。

最后,检查 Inspector 是否绑定了所有引用。缺少 PlayerHealth、Slider 或 Text 会导致空引用异常;初次排查时应先查看 Console,再检查对应对象是否存在、组件是否启用,以及场景里是否误放了多个独立的生命值数据源。

这里的关键并不是换一种方式给血条赋值,而是明确状态由玩法系统持有,显示由 UI 消费,刷新由状态变化驱动。这种结构能减少无效更新,也能让后续 HUD 扩展保持独立。

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

目录与阅读设置

阅读设置

17

记录一个想法

同步生命值与状态文本

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

登录哪都通