游戏客户端架构 / 系统课时

让界面更新具备可测试的边界

让界面更新具备可测试的边界

HUD 最容易变成“状态一变就直接改控件”的代码,最终既难复现异常,也只能启动完整游戏验证。本节把状态计算、显示格式化和视图渲染拆成明确边界,使血量、金币等关键行为可以脱离场景和 UI 框架独立测试。

学习目标

  • 区分状态计算、显示格式化与视图渲染三种职责
  • 用纯函数为关键 HUD 规则建立稳定的自动化测试边界
  • 让真正依赖 UI 控件的代码保持足够薄,便于替换和模拟

把一次界面更新拆成三段

假设玩家受到伤害后,HUD 要同时更新血量文字和血条长度。直接在事件回调里读取玩家对象、计算比例、拼接文字并修改控件,短期代码最少,但所有逻辑都会依赖运行中的游戏场景。

更容易测试的链路是:原始状态 → 可显示状态 → 显示文本 → 视图适配器。前两段只处理数据,不访问按钮、文本控件、节点或场景树;最后一段才接触真正的 UI。

HUD 更新链路与测试边界

这样拆分的关键不是文件数量,而是依赖方向:负责规则的代码不知道界面控件存在,负责渲染的代码也不重新计算业务规则。

用纯函数固定状态计算和格式化

下面用 TypeScript 演示一个可以直接运行的最小例子。calculateHudState 负责边界处理,formatHud 只决定展示形式,renderHud 只把结果写入视图接口。

ts
interface PlayerState {
  hp: number;
  maxHp: number;
  coins: number;
}

interface HudState {
  hp: number;
  maxHp: number;
  hpRatio: number;
  coins: number;
}

interface HudText {
  hpText: string;
  coinText: string;
}

interface HudView {
  setHpText(text: string): void;
  setHpFill(ratio: number): void;
  setCoinText(text: string): void;
}

function calculateHudState(player: PlayerState): HudState {
  const maxHp = Math.max(1, player.maxHp);
  const hp = Math.min(Math.max(player.hp, 0), maxHp);

  return {
    hp,
    maxHp,
    hpRatio: hp / maxHp,
    coins: Math.max(0, player.coins),
  };
}

function formatHud(state: HudState): HudText {
  return {
    hpText: `HP ${state.hp} / ${state.maxHp}`,
    coinText: `Coins ${state.coins}`,
  };
}

function renderHud(view: HudView, state: HudState, text: HudText): void {
  // 这一层只负责把已经确定的结果交给具体控件。
  view.setHpText(text.hpText);
  view.setHpFill(state.hpRatio);
  view.setCoinText(text.coinText);
}

class FakeHudView implements HudView {
  hpText = "";
  hpFill = 0;
  coinText = "";

  setHpText(text: string): void { this.hpText = text; }
  setHpFill(ratio: number): void { this.hpFill = ratio; }
  setCoinText(text: string): void { this.coinText = text; }
}

function assertEqual<T>(actual: T, expected: T, message: string): void {
  if (actual !== expected) {
    throw new Error(`${message}: expected=${expected}, actual=${actual}`);
  }
}

const state = calculateHudState({ hp: 80, maxHp: 100, coins: 1250 });
const text = formatHud(state);
const view = new FakeHudView();
renderHud(view, state, text);

assertEqual(state.hpRatio, 0.8, "hpRatio");
assertEqual(view.hpText, "HP 80 / 100", "hpText");
assertEqual(view.coinText, "Coins 1250", "coinText");

console.log(view.hpText);
console.log(`fill=${view.hpFill.toFixed(2)}`);
console.log(view.coinText);
console.log("tests passed");

预期输出:

text
HP 80 / 100
fill=0.80
Coins 1250
tests passed

这里最值得测试的不是“某个文本控件有没有被找到”,而是输入状态确定后,得到的比例、边界值和显示内容是否确定。即使以后把 HUD 从一种 UI 框架迁到另一种框架,这些测试仍然有效。

把渲染层限制为薄适配器

真正的游戏项目里,HudView 的实现可以包装 Unity、Unreal、Godot 或自研 UI 控件。适配器允许依赖引擎 API,但不应该重新判断“血量是否小于零”“金币如何格式化”等规则,否则同一逻辑会在测试层和渲染层重复出现。

测试渲染边界时,也不需要创建完整窗口。像示例中的 FakeHudView 一样记录收到的值,就能验证更新链路是否向正确控件提交了正确结果。只有布局、动画、字体裁切等真正依赖渲染系统的行为,才值得进入集成测试或运行时测试。

优先覆盖会改变玩家感知的边界

UI 测试不需要追求每行代码都有断言。优先覆盖玩家能直接感知、并且容易因边界值出错的规则,例如生命值低于零时是否归零、最大生命值异常时是否避免除零、货币是否允许显示负数,以及相同状态重复刷新时是否得到相同结果。

状态计算与格式化保持纯净以后,大部分关键行为都能通过快速的单元测试完成;渲染层只验证“数据有没有正确送到控件”。这种边界既降低测试成本,也让后续更换 HUD 皮肤、控件库或渲染实现时,不必重新证明业务规则仍然正确。

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

目录与阅读设置

阅读设置

17

记录一个想法

让界面更新具备可测试的边界

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

登录哪都通