游戏引擎 / 系统课时
让 UI 数据源保持单一
让 UI 数据源保持单一
血条已经扣到一半,生命值文字却还是满血,通常不是绘制错误,而是多个 UI 脚本在分别维护同一份状态。本课把生命值留在玩法组件中,由变化事件驱动血条和文字一起更新,并处理 UI 启停时的订阅与重新同步。
学习目标
- 分清玩法真实状态与 UI 显示副本的职责。
- 用单向事件流同步多个控件,而不是让控件互相调用。
- 通过初始刷新、取消订阅和重新启用验证数据一致性。
确定生命值由谁说了算
一个玩家的生命值只由 PlayerHealth 持有:CurrentHealth 和 MaxHealth 是真实数据。伤害、治疗等操作只能请求该组件改值;Slider.value 和文本内容只是渲染结果,不能反过来作为战斗判定依据。
“单一数据源”不等于整个游戏只有一个全局单例。每个玩家都可以有自己的 PlayerHealth;关键是同一玩家的生命值只有一个可写入口,HUD、飘字、音效等消费者都从这里取得一致的信息。
让变化沿一个方向传播
数据流为“伤害或治疗请求 → PlayerHealth 校验并修改状态 → HealthChanged 事件 → HealthHud 同时刷新 Slider 和文字”。UI 的按钮可以向模型发送命令,但血条不应该再直接通知生命值文字更新,也不应保存另一份可修改的生命值。

事件只报告“有变化”,不负责提供订阅前的历史状态。因此 HUD 首次显示时必须主动读取一次当前值;若面板隐藏期间错过了事件,重新显示也要再次读取。这样才不会出现先加载 UI、后扣血或隐藏再展开时的数据漂移。
实现模型和HUD订阅者
创建 PlayerHealth.cs 并挂到玩家对象。以下是配套示例的模型部分;它不依赖任何 UI 组件,边界检查和事件发布都由数据源完成。
using System;
using UnityEngine;
public 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()
{
CurrentHealth = maxHealth;
}
public void Damage(int amount)
{
if (amount <= 0) return;
SetHealth(CurrentHealth - amount);
}
public void Heal(int amount)
{
if (amount <= 0) return;
SetHealth(CurrentHealth + amount);
}
private void SetHealth(int value)
{
// 只有真正发生数值变化时才通知所有订阅者。
int next = Mathf.Clamp(value, 0, MaxHealth);
if (next == CurrentHealth) return;
CurrentHealth = next;
HealthChanged?.Invoke(CurrentHealth, MaxHealth);
}
}创建 HealthHud.cs 并挂到 HUD 容器。OnEnable 订阅、OnDisable 取消订阅;Start 在场景对象完成 Awake 后执行首次刷新。重新启用时再次读取数据,弥补隐藏期间漏掉的变化。
using TMPro;
using UnityEngine;
using UnityEngine.UI;
public class HealthHud : MonoBehaviour
{
[SerializeField] private PlayerHealth source;
[SerializeField] private Slider slider;
[SerializeField] private TMP_Text healthText;
private bool started;
private void OnEnable()
{
if (source == null) return;
source.HealthChanged += Refresh;
// 重新显示后主动追上真实状态。
if (started) Refresh(source.CurrentHealth, source.MaxHealth);
}
private void Start()
{
started = true;
if (source != null) Refresh(source.CurrentHealth, source.MaxHealth);
}
private void OnDisable()
{
if (source != null) source.HealthChanged -= Refresh;
}
private void Refresh(int current, int max)
{
// 两个控件从同一次状态通知渲染,不读取彼此的值。
slider.minValue = 0;
slider.maxValue = max;
slider.value = current;
healthText.text = $"{current}/{max}";
}
}预期结果:玩家最大生命值设为 100 时,HUD 初次显示 100/100 且血条充满;调用 Damage(25) 后同步显示 75/100,再调用 Heal(10) 后显示 85/100。连续扣血不会低于 0,治疗不会超过 100,数值不变时不会重复派发事件。
在场景中接线和验证
- 在 Canvas 下创建
Slider与 TextMeshPro 文本,并把HealthHud挂到二者共同的 HUD 容器;将玩家的PlayerHealth、Slider、文字拖到对应引用字段。 - 临时创建“受伤”和“治疗”按钮。在各自
On Click()事件中拖入玩家对象,选择PlayerHealth.Damage(int)、PlayerHealth.Heal(int),使用静态整型参数25与10。 - 运行后按“受伤 → 治疗”,核对显示依次为
100/100 → 75/100 → 85/100。再将 HUD 容器暂时禁用,通过其他玩法逻辑修改生命值,重新启用后应立即显示最新值。 - 检查脚本引用都已绑定;若出现
NullReferenceException,优先确认source、slider、healthText未漏拖,且 TextMeshPro 资源已正确安装或导入。
避免多份状态重新出现
战斗规则只能询问 PlayerHealth.CurrentHealth,不能依赖血条的 value,因为 HUD 可能被隐藏、销毁或换成另一种表现形式。HealthChanged 传递当前值和上限,其他 UI 也能各自派生百分比或警告阈值,不需要相互引用。