游戏客户端架构 / 系统课时
综合实战:搭建战斗 HUD 与菜单
综合实战:搭建战斗 HUD 与菜单
本节把战斗状态、HUD、菜单栈、弹窗、输入切换和资源加载组合成一个最小可扩展架构。完成后,你会得到一套“状态变化驱动界面、栈管理层级、统一入口处理输入”的实现方式,而不是在各个按钮和场景脚本里直接开关 UI。
学习目标
- 设计战斗 HUD、菜单和弹窗之间的职责边界
- 用状态驱动与界面栈统一控制显示、输入和暂停
- 通过异步资源加载和生命周期管理避免重复实例与资源泄漏
先确定最小架构
战斗 UI 可以先拆成五个角色:GameState 保存可观察状态,HudView 只渲染战斗信息,UiStack 管理菜单层级,ModalService 管理阻塞式弹窗,UiResourceLoader 负责异步加载和复用界面资源。业务代码只调用这些入口,不直接操作具体节点。

这套拆分解决两个常见问题:第一,暂停菜单不应该知道玩家血量如何计算;第二,玩家状态变化也不应该通过“找到某个 UI 节点再改文本”来传播。状态与展示分离后,场景切换或 HUD 换皮时不会牵连战斗逻辑。
用状态驱动 HUD
下面用 TypeScript 写一个可运行的最小示例。BattleState 只负责状态和订阅,BattleHud 订阅后渲染文本;真实项目里可把 render 替换为引擎的文本组件更新。
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();预期输出:
HP 100/100 | Ammo 30
HP 72/100 | Ammo 30
HP 72/100 | Ammo 18关键点是 mount 建立订阅、unmount 解除订阅。只做前半步会让已关闭的界面继续接收状态更新,长期运行后容易出现重复回调、对象无法释放或同一 HUD 被刷新多次。
用界面栈管理菜单层级
暂停菜单、设置菜单和背包这类可返回界面,适合用栈管理。打开新菜单时压栈,返回时弹栈;栈顶拥有交互焦点。弹窗则不应混在普通菜单栈里,因为确认框通常需要阻止下层所有输入。
可以把核心约束固定为:
- HUD 常驻底层,不参与普通“返回”操作。
- 普通菜单进入
UiStack,只有栈顶可接收导航输入。 - 弹窗进入
ModalService,存在弹窗时暂停向菜单栈分发输入。 - 栈从空变为非空时切换到 UI 输入上下文;恢复为空时切回战斗输入。
- 场景退出时统一清空栈、弹窗和订阅,不让旧场景 UI 残留。
把资源加载放进统一入口
大型菜单通常包含图片、字体、动画或子面板,不适合在场景启动时全部实例化。UiResourceLoader 应该按界面 ID 加载资源,并由 UiStack 决定何时创建实例。常用策略是“资源可缓存,实例按需创建”,而不是所有页面永久常驻。
资源加载需要处理三个边界:重复打开同一页面时复用正在进行的加载任务;页面关闭后释放事件订阅和临时对象;场景销毁时取消还未完成但已经失去意义的请求。这样才能避免快速连按菜单键时创建多个相同页面。
验证时不要只看“页面能打开”。连续执行“打开暂停菜单 → 进入设置 → 返回 → 关闭暂停菜单”十几次,再观察实例数、订阅数和资源引用是否恢复到初始水平。
按一条输入链路完成验收
最终验收应从玩家动作而不是单个类出发:战斗中按暂停键,InputRouter 把输入交给 UI;UiStack 打开暂停菜单并接管焦点;进入设置后新页面压栈;弹出确认框时 ModalService 阻断下层;关闭所有菜单后输入重新交给战斗。
同时修改玩家生命值,HUD 应持续刷新,但暂停菜单不直接读取角色组件;切换场景后旧 HUD 不再收到任何状态通知。只要这条链路成立,后续新增背包、任务、地图或二级弹窗时,就可以沿用同一套状态、栈、输入和资源边界,而不必继续堆叠场景脚本。