游戏引擎 / 系统课时

让玩法逻辑脱离具体 UI

让玩法逻辑脱离具体 UI

拾取金币时直接修改 Label 虽然方便,但更换 HUD、隐藏界面或增加结算页时,玩法脚本也会被迫修改。本课把状态与加分规则留在纯 TypeScript 层,由游戏对象触发动作、HUD 订阅结果,做出不依赖特定界面的得分闭环。

学习目标

  • 区分状态、玩法规则与界面组件各自的职责。
  • 用状态订阅推动 HUD 刷新,并正确清理订阅关系。
  • 验证 HUD 被禁用时,玩法状态仍能正常变化。

确定数据流方向

假设每拾取一枚金币获得 10 分。常见的耦合写法是在拾取回调里调用 scoreLabel.string = ...:这要求拾取对象持有 UI 引用;如果 Label 没有挂载或 HUD 被销毁,业务逻辑就可能出错。

更稳妥的方向是:游戏行为触发规则,规则修改状态,状态通知观察者,HUD 根据状态渲染。UI 可以发起操作,但不应成为规则存储分数的地方。结算页或音效系统以后也能独立订阅同一结果。

金币拾取经规则和状态对象单向驱动 HUD 的架构与订阅生命周期

在纯 TypeScript 中维护状态

下面是一组完整的场景示例,由三个文件组成,分别保存到 assets/scripts/。其中每个文件都是组合示例的一部分,单独放置文件不会产生界面效果。

GameState.ts 不导入任何 Cocos 节点或 UI 类型。score 是内部状态,collectCoin 是统一的得分规则,subscribe 注册监听时还会立即发送当前值,避免 HUD 重开后显示旧分数。

ts
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、面板是否可见。为了独立验证,稍后把它的公开方法绑定到测试按钮;实际项目中也可以在已确认有效的金币碰撞回调里调用它。

ts
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 都不会改变得分规则,也不会留下失效回调。

ts
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 组件的节点。

连接场景并验证边界

  1. 在 Canvas 下创建 HUD 节点,内部放一个带 Label 的 ScoreLabel;把 ScoreHud 挂到 HUD,并将 ScoreLabel 的 Label 拖入 scoreLabel 属性。
  2. 在 Canvas 下另建 GameAction 节点并挂 CoinPickup;创建一个不属于 HUD 的测试 Button。
  3. 在 Button 的 Click Events 中添加事件,将目标设为 GameAction,组件选 CoinPickup,处理函数选 onCoinCollected。
  4. 浏览器预览后点击两次按钮;再禁用 HUD,继续点击一次,最后重新启用 HUD。

Cocos Creator 3.8 Button 点击事件绑定至 CoinPickup 方法的界面

预期结果(Label 显示内容):

text
初始:得分:0
点击一次:得分:10
点击两次:得分:20
HUD 隐藏时再点一次,重新显示:得分:30

如果分数没有变化,先检查 Button 事件是否确实指向 CoinPickup;若规则已运行而文字不更新,检查 Label 引用和 HUD 的激活状态。测试按钮只是动作入口,不承担加分计算。

判断是否真正解耦的标准很简单:删除或替换 ScoreHud 后,拾取金币仍能正确计分;新增第二套 UI 时,也不必修改 collectCoin 的规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

让玩法逻辑脱离具体 UI

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

登录哪都通