游戏引擎 / 系统课时
用事件解耦 UI 与核心逻辑
用事件解耦 UI 与核心逻辑
计分规则直接寻找场景中的 Label,会让规则依赖某个 UI 节点名称,界面重建时也容易失效。本节让模型拥有分数并发布变化,UI 订阅事件,同时用当前快照解决晚订阅问题。
学习目标
- 用 EventTarget 发布状态变化
- 在订阅时先读取当前快照
- 成对移除监听并明确事件协议
确定事件的方向
按钮发出“开始游戏”的意图,规则验证后更新状态,再发出“分数已变化”的事实,两种事件不应混淆。模型不需要知道 Label 在哪个 Canvas 下,UI 也不应收到变化事件后再自行加一次分。

事件通常只通知订阅之后的变化,无法保证晚创建的 UI 收到历史事件。因此启用时先渲染当前模型快照,再订阅后续变化;复杂异步系统还应考虑订阅与读取间的竞态,本节同步场景中两步不会跨异步等待。
实现一个完整计分通路
保存为 ScorePanel.ts,挂到 Label 节点。为了独立运行,模块内同时定义最小模型与事件总线;正式项目可拆分文件,但仍应只有一个分数拥有者。启动演示奖励 10 分。
ts
import { _decorator, Component, EventTarget, Label } from 'cc';
const { ccclass } = _decorator;
export const scoreEvents = new EventTarget();
let score = 0;
export function award(points: number): void {
if (!Number.isInteger(points) || points <= 0) return;
score += points;
scoreEvents.emit('score', score); // 发布完整快照,不发布“再加一次”
}
@ccclass('ScorePanel')
export class ScorePanel extends Component {
private label: Label | null = null;
onEnable(): void {
this.label = this.getComponent(Label);
this.render(score); // 晚创建的界面也能显示当前值
scoreEvents.on('score', this.render, this);
}
start(): void { award(10); }
onDisable(): void { scoreEvents.off('score', this.render, this); }
private render(value: number): void {
if (this.label) this.label.string = 'Score: ' + value;
}
}预期结果:运行后 Label 显示 Score: 10。停用再启用同一个组件仍显示 10,start 不会因每次启用重复奖励;新创建第二个 ScorePanel 会执行自己的 start 并再奖励,这是演示入口的行为,正式 UI 应移除这个 start,把奖励放回唯一业务入口。
保持协议小而明确
记录事件名、参数类型和发布时机,避免一个调用传数字、另一个传对象。普通 EventTarget 不会自动检查跨模块的字符串协议,可在外层提供类型明确的方法,缩小散落的 emit 调用。不要在任意 UI 中重新创建同名总线,否则订阅与发布将落在不同对象上。
跨场景事件总线可能长期存活,UI 销毁时必须解除监听,避免旧组件被引用。对象池回收 UI 也应遵守同一规则。测试多次隐藏、重建与换场景,确认一次 award 只改变一次模型、每个活跃界面只刷新一次。
按自己的节奏,确认真正理解。