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

综合实战:搭建战斗 HUD 与菜单

综合实战:搭建战斗 HUD 与菜单

本节把战斗状态、HUD、菜单栈、弹窗、输入切换和资源加载组合成一个最小可扩展架构。完成后,你会得到一套“状态变化驱动界面、栈管理层级、统一入口处理输入”的实现方式,而不是在各个按钮和场景脚本里直接开关 UI。

学习目标

  • 设计战斗 HUD、菜单和弹窗之间的职责边界
  • 用状态驱动与界面栈统一控制显示、输入和暂停
  • 通过异步资源加载和生命周期管理避免重复实例与资源泄漏

先确定最小架构

战斗 UI 可以先拆成五个角色:GameState 保存可观察状态,HudView 只渲染战斗信息,UiStack 管理菜单层级,ModalService 管理阻塞式弹窗,UiResourceLoader 负责异步加载和复用界面资源。业务代码只调用这些入口,不直接操作具体节点。

战斗 UI 组件关系与数据流

这套拆分解决两个常见问题:第一,暂停菜单不应该知道玩家血量如何计算;第二,玩家状态变化也不应该通过“找到某个 UI 节点再改文本”来传播。状态与展示分离后,场景切换或 HUD 换皮时不会牵连战斗逻辑。

用状态驱动 HUD

下面用 TypeScript 写一个可运行的最小示例。BattleState 只负责状态和订阅,BattleHud 订阅后渲染文本;真实项目里可把 render 替换为引擎的文本组件更新。

ts
type BattleSnapshot = {
  hp: number;
  maxHp: number;
  ammo: number;
};

type Listener = (state: BattleSnapshot) => void;

class BattleState {
  private state: BattleSnapshot = { hp: 100, maxHp: 100, ammo: 30 };
  private listeners = new Set<Listener>();

  subscribe(listener: Listener): () => void {
    this.listeners.add(listener);
    listener(this.state);
    return () => this.listeners.delete(listener);
  }

  update(patch: Partial<BattleSnapshot>): void {
    this.state = { ...this.state, ...patch };
    for (const listener of this.listeners) listener(this.state);
  }
}

class BattleHud {
  private unsubscribe?: () => void;

  mount(state: BattleState): void {
    this.unsubscribe = state.subscribe(snapshot => this.render(snapshot));
  }

  unmount(): void {
    this.unsubscribe?.();
  }

  private render(state: BattleSnapshot): void {
    console.log(`HP ${state.hp}/${state.maxHp} | Ammo ${state.ammo}`);
  }
}

const state = new BattleState();
const hud = new BattleHud();

hud.mount(state);
state.update({ hp: 72 });
state.update({ ammo: 18 });
hud.unmount();

预期输出:

text
HP 100/100 | Ammo 30
HP 72/100 | Ammo 30
HP 72/100 | Ammo 18

关键点是 mount 建立订阅、unmount 解除订阅。只做前半步会让已关闭的界面继续接收状态更新,长期运行后容易出现重复回调、对象无法释放或同一 HUD 被刷新多次。

用界面栈管理菜单层级

暂停菜单、设置菜单和背包这类可返回界面,适合用栈管理。打开新菜单时压栈,返回时弹栈;栈顶拥有交互焦点。弹窗则不应混在普通菜单栈里,因为确认框通常需要阻止下层所有输入。

可以把核心约束固定为:

  1. HUD 常驻底层,不参与普通“返回”操作。
  2. 普通菜单进入 UiStack,只有栈顶可接收导航输入。
  3. 弹窗进入 ModalService,存在弹窗时暂停向菜单栈分发输入。
  4. 栈从空变为非空时切换到 UI 输入上下文;恢复为空时切回战斗输入。
  5. 场景退出时统一清空栈、弹窗和订阅,不让旧场景 UI 残留。

把资源加载放进统一入口

大型菜单通常包含图片、字体、动画或子面板,不适合在场景启动时全部实例化。UiResourceLoader 应该按界面 ID 加载资源,并由 UiStack 决定何时创建实例。常用策略是“资源可缓存,实例按需创建”,而不是所有页面永久常驻。

资源加载需要处理三个边界:重复打开同一页面时复用正在进行的加载任务;页面关闭后释放事件订阅和临时对象;场景销毁时取消还未完成但已经失去意义的请求。这样才能避免快速连按菜单键时创建多个相同页面。

验证时不要只看“页面能打开”。连续执行“打开暂停菜单 → 进入设置 → 返回 → 关闭暂停菜单”十几次,再观察实例数、订阅数和资源引用是否恢复到初始水平。

按一条输入链路完成验收

最终验收应从玩家动作而不是单个类出发:战斗中按暂停键,InputRouter 把输入交给 UI;UiStack 打开暂停菜单并接管焦点;进入设置后新页面压栈;弹出确认框时 ModalService 阻断下层;关闭所有菜单后输入重新交给战斗。

同时修改玩家生命值,HUD 应持续刷新,但暂停菜单不直接读取角色组件;切换场景后旧 HUD 不再收到任何状态通知。只要这条链路成立,后续新增背包、任务、地图或二级弹窗时,就可以沿用同一套状态、栈、输入和资源边界,而不必继续堆叠场景脚本。

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

目录与阅读设置

阅读设置

17

记录一个想法

综合实战:搭建战斗 HUD 与菜单

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

登录哪都通