游戏引擎 / 系统课时

让 UI 数据源保持单一

让 UI 数据源保持单一

血条已经扣到一半,生命值文字却还是满血,通常不是绘制错误,而是多个 UI 脚本在分别维护同一份状态。本课把生命值留在玩法组件中,由变化事件驱动血条和文字一起更新,并处理 UI 启停时的订阅与重新同步。

学习目标

  • 分清玩法真实状态与 UI 显示副本的职责。
  • 用单向事件流同步多个控件,而不是让控件互相调用。
  • 通过初始刷新、取消订阅和重新启用验证数据一致性。

确定生命值由谁说了算

一个玩家的生命值只由 PlayerHealth 持有:CurrentHealth 和 MaxHealth 是真实数据。伤害、治疗等操作只能请求该组件改值;Slider.value 和文本内容只是渲染结果,不能反过来作为战斗判定依据。

“单一数据源”不等于整个游戏只有一个全局单例。每个玩家都可以有自己的 PlayerHealth;关键是同一玩家的生命值只有一个可写入口,HUD、飘字、音效等消费者都从这里取得一致的信息。

让变化沿一个方向传播

数据流为“伤害或治疗请求 → PlayerHealth 校验并修改状态 → HealthChanged 事件 → HealthHud 同时刷新 Slider 和文字”。UI 的按钮可以向模型发送命令,但血条不应该再直接通知生命值文字更新,也不应保存另一份可修改的生命值。

生命值唯一数据源和HUD的单向更新链路

事件只报告“有变化”,不负责提供订阅前的历史状态。因此 HUD 首次显示时必须主动读取一次当前值;若面板隐藏期间错过了事件,重新显示也要再次读取。这样才不会出现先加载 UI、后扣血或隐藏再展开时的数据漂移。

实现模型和HUD订阅者

创建 PlayerHealth.cs 并挂到玩家对象。以下是配套示例的模型部分;它不依赖任何 UI 组件,边界检查和事件发布都由数据源完成。

csharp
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 后执行首次刷新。重新启用时再次读取数据,弥补隐藏期间漏掉的变化。

csharp
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,数值不变时不会重复派发事件。

在场景中接线和验证

  1. 在 Canvas 下创建 Slider 与 TextMeshPro 文本,并把 HealthHud 挂到二者共同的 HUD 容器;将玩家的 PlayerHealth、Slider、文字拖到对应引用字段。
  2. 临时创建“受伤”和“治疗”按钮。在各自 On Click() 事件中拖入玩家对象,选择 PlayerHealth.Damage(int)、PlayerHealth.Heal(int),使用静态整型参数 25 与 10。
  3. 运行后按“受伤 → 治疗”,核对显示依次为 100/100 → 75/100 → 85/100。再将 HUD 容器暂时禁用,通过其他玩法逻辑修改生命值,重新启用后应立即显示最新值。
  4. 检查脚本引用都已绑定;若出现 NullReferenceException,优先确认 source、slider、healthText 未漏拖,且 TextMeshPro 资源已正确安装或导入。

避免多份状态重新出现

战斗规则只能询问 PlayerHealth.CurrentHealth,不能依赖血条的 value,因为 HUD 可能被隐藏、销毁或换成另一种表现形式。HealthChanged 传递当前值和上限,其他 UI 也能各自派生百分比或警告阈值,不需要相互引用。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 UI 数据源保持单一

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

登录哪都通