游戏客户端架构 / 系统课时
用状态模型驱动血条和资源条
用状态模型驱动血条和资源条
血条、法力条、耐力条的共同问题不是“怎么设置 Slider”,而是如何保证多个 HUD 元素读取同一份可信状态,并且只沿一个方向更新。本节建立一个最小状态模型,把生命值和资源值统一成可订阅数据,再由 HUD 组件完成显示。
学习目标
- 设计适合 HUD 的最小状态模型,并区分真实值与显示值
- 建立“业务修改状态 → 状态发出变化 → 视图渲染”的单向链路
- 正确处理初始化、边界钳制和订阅释放
状态模型只保存业务真值
HUD 不应把进度条当前值当作游戏真实状态。真正的生命值、法力值应该存在独立模型中,UI 只是模型的一个观察者。这样即使 HUD 被隐藏、重建或切换皮肤,业务值也不会丢失。
生命值和法力值都可以抽象成“当前值 + 最大值”。下面给出一个可复用的 C# 片段示例;它负责边界钳制,并且只有数值发生变化时才通知订阅者。
using System;
public sealed class ResourceValue
{
public event Action<int, int> Changed = delegate { };
public int Current { get; private set; }
public int Max { get; }
public ResourceValue(int max, int initial)
{
if (max <= 0) throw new ArgumentOutOfRangeException(nameof(max));
Max = max;
Current = Clamp(initial, 0, max);
}
public void Set(int value)
{
int next = Clamp(value, 0, Max);
if (next == Current) return;
Current = next;
Changed(Current, Max);
}
private static int Clamp(int value, int min, int max)
{
return Math.Min(Math.Max(value, min), max);
}
}这个模型不依赖具体 UI 控件,因此血条、法力条、Boss 条都可以复用。
单向链路避免 UI 反写业务
完整链路应只有一个主方向:战斗或技能系统修改模型,模型通知变化,HUD 根据新值渲染。HUD 不把 Slider.value 再写回模型,否则拖动动画、补间效果或控件内部变化都可能误伤真实状态。

一个常见组织方式是让角色状态对象聚合多个资源模型,而 HUD 绑定这个状态对象。
public sealed class PlayerStatus
{
public ResourceValue Health { get; }
public ResourceValue Mana { get; }
public PlayerStatus(int maxHealth, int maxMana)
{
Health = new ResourceValue(maxHealth, maxHealth);
Mana = new ResourceValue(maxMana, maxMana);
}
}战斗系统只调用 Health.Set(...),技能系统只调用 Mana.Set(...)。它们不需要知道当前 HUD 使用的是横条、圆环还是纯文本。
HUD 绑定一次并分别渲染
下面是 Unity 组件片段示例。场景需要预先绑定两个 Slider 和两个 Text,并在创建角色状态后调用 Bind。
using UnityEngine;
using UnityEngine.UI;
public sealed class PlayerHud : MonoBehaviour
{
[SerializeField] private Slider healthBar;
[SerializeField] private Slider manaBar;
[SerializeField] private Text healthText;
[SerializeField] private Text manaText;
private PlayerStatus status;
public void Bind(PlayerStatus playerStatus)
{
Unsubscribe();
status = playerStatus;
if (isActiveAndEnabled)
{
Subscribe();
RenderAll();
}
}
private void OnEnable()
{
if (status == null) return;
Subscribe();
RenderAll();
}
private void OnDisable()
{
Unsubscribe();
}
private void Subscribe()
{
status.Health.Changed += RenderHealth;
status.Mana.Changed += RenderMana;
}
private void Unsubscribe()
{
if (status == null) return;
status.Health.Changed -= RenderHealth;
status.Mana.Changed -= RenderMana;
}
private void RenderAll()
{
RenderHealth(status.Health.Current, status.Health.Max);
RenderMana(status.Mana.Current, status.Mana.Max);
}
private void RenderHealth(int current, int max)
{
healthBar.maxValue = max;
healthBar.value = current;
healthText.text = $"{current}/{max}";
}
private void RenderMana(int current, int max)
{
manaBar.maxValue = max;
manaBar.value = current;
manaText.text = $"{current}/{max}";
}
}验证时把生命值从 100 改为 75,只应触发生命值相关渲染;把法力值从 50 改为 20,只应更新法力条。两类资源互不干扰,且 UI 不需要每帧检查任何值。
显示动画不要污染真实状态
实际游戏常把血条做成缓动,例如真实血量立即从 100 变为 60,画面上的条在 0.2 秒内滑到 60。此时模型中的 Current 必须立即是 60,缓动只属于视图层。
可以把 RenderHealth 收到的目标值交给 Tween 或协程,让显示值逐步逼近目标值,但伤害判定、死亡判断和存档都继续读取模型。这样“真实状态”和“视觉表现”不会因为动画时差互相污染。
当 HUD 中资源种类继续增加时,也应优先扩展状态模型和绑定层,而不是让每个控件自行寻找业务对象。保持“业务改状态,状态通知视图,视图只渲染”这一方向,血条、资源条和后续状态图标就能共享同一种更新方式。