游戏引擎 / 系统课时
让玩法逻辑脱离具体 UI
让玩法逻辑脱离具体 UI
拾取金币时直接修改 Label 虽然方便,但更换 HUD、隐藏界面或增加结算页时,玩法脚本也会被迫修改。本课把状态与加分规则留在纯 TypeScript 层,由游戏对象触发动作、HUD 订阅结果,做出不依赖特定界面的得分闭环。
学习目标
- 区分状态、玩法规则与界面组件各自的职责。
- 用状态订阅推动 HUD 刷新,并正确清理订阅关系。
- 验证 HUD 被禁用时,玩法状态仍能正常变化。
确定数据流方向
假设每拾取一枚金币获得 10 分。常见的耦合写法是在拾取回调里调用 scoreLabel.string = ...:这要求拾取对象持有 UI 引用;如果 Label 没有挂载或 HUD 被销毁,业务逻辑就可能出错。
更稳妥的方向是:游戏行为触发规则,规则修改状态,状态通知观察者,HUD 根据状态渲染。UI 可以发起操作,但不应成为规则存储分数的地方。结算页或音效系统以后也能独立订阅同一结果。

在纯 TypeScript 中维护状态
下面是一组完整的场景示例,由三个文件组成,分别保存到 assets/scripts/。其中每个文件都是组合示例的一部分,单独放置文件不会产生界面效果。
GameState.ts 不导入任何 Cocos 节点或 UI 类型。score 是内部状态,collectCoin 是统一的得分规则,subscribe 注册监听时还会立即发送当前值,避免 HUD 重开后显示旧分数。
type ScoreListener = (score: number) => void;
class GameState {
private score = 0;
private listeners = new Set<ScoreListener>();
addScore(delta: number): void {
if (!Number.isFinite(delta) || delta <= 0) return;
this.score += delta;
// 状态改变后统一通知,业务层无需知道谁在展示。
this.listeners.forEach(listener => listener(this.score));
}
subscribe(listener: ScoreListener): () => void {
this.listeners.add(listener);
listener(this.score); // 新 UI 立即获得当前状态
return () => { this.listeners.delete(listener); };
}
}
export const gameState = new GameState();
export function collectCoin(): void {
gameState.addScore(10); // 一枚金币的得分规则
}该模块的生效行为是每次调用 collectCoin() 使状态增加 10 分,并把新值通知已注册的监听者;最终结果通过下方场景测试验证。
由游戏对象调用规则
CoinPickup.ts 仅负责接收拾取动作,不关心 Label、面板是否可见。为了独立验证,稍后把它的公开方法绑定到测试按钮;实际项目中也可以在已确认有效的金币碰撞回调里调用它。
import { _decorator, Component } from 'cc';
import { collectCoin } from './GameState';
const { ccclass } = _decorator;
@ccclass('CoinPickup')
export class CoinPickup extends Component {
// 触发入口与具体 UI 解耦,规则保持唯一。
public onCoinCollected(): void {
collectCoin();
}
}这个片段需要挂载到场景节点,只有调用 onCoinCollected() 才会改变分数;不需要给它配置 HUD 引用。
让 HUD 只订阅和显示
ScoreHud.ts 只将得分转成 Label 文本。onEnable 订阅并读取当前值,onDisable 解除订阅;这样隐藏、恢复或切换 UI 都不会改变得分规则,也不会留下失效回调。
import { _decorator, Component, Label } from 'cc';
import { gameState } from './GameState';
const { ccclass, property } = _decorator;
@ccclass('ScoreHud')
export class ScoreHud extends Component {
@property(Label)
public scoreLabel: Label | null = null;
private unsubscribe: (() => void) | null = null;
protected onEnable(): void {
// 订阅时立即同步当前得分,避免重开界面显示旧值。
this.unsubscribe = gameState.subscribe(score => {
if (this.scoreLabel) this.scoreLabel.string = `得分:${score}`;
});
}
protected onDisable(): void {
// UI 失活必须退订,否则会保留无用的监听关系。
this.unsubscribe?.();
this.unsubscribe = null;
}
}这段代码同样是组合示例的组件文件,必须先在编辑器中为 scoreLabel 指定一个带 Label 组件的节点。
连接场景并验证边界
- 在 Canvas 下创建
HUD节点,内部放一个带 Label 的ScoreLabel;把ScoreHud挂到 HUD,并将ScoreLabel的 Label 拖入scoreLabel属性。 - 在 Canvas 下另建
GameAction节点并挂CoinPickup;创建一个不属于 HUD 的测试 Button。 - 在 Button 的
Click Events中添加事件,将目标设为GameAction,组件选CoinPickup,处理函数选onCoinCollected。 - 浏览器预览后点击两次按钮;再禁用 HUD,继续点击一次,最后重新启用 HUD。

预期结果(Label 显示内容):
初始:得分:0
点击一次:得分:10
点击两次:得分:20
HUD 隐藏时再点一次,重新显示:得分:30如果分数没有变化,先检查 Button 事件是否确实指向 CoinPickup;若规则已运行而文字不更新,检查 Label 引用和 HUD 的激活状态。测试按钮只是动作入口,不承担加分计算。
判断是否真正解耦的标准很简单:删除或替换 ScoreHud 后,拾取金币仍能正确计分;新增第二套 UI 时,也不必修改 collectCoin 的规则。