游戏引擎 / 系统课时

用事件解耦 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 只改变一次模型、每个活跃界面只刷新一次。

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

目录与阅读设置

阅读设置

17

记录一个想法

用事件解耦 UI 与核心逻辑

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

登录哪都通