游戏引擎 / 系统课时
绑定和解绑 Node 事件
绑定和解绑 Node 事件
按钮每次重新打开后多执行一次,通常是监听随启用不断增加,却没有在停用时解除。本节给一个 UI 节点绑定触摸结束事件,用稳定的方法引用和 target 完成成对解绑,并通过停用再启用验证监听不会积累。
学习目标
- 在正确的生命周期内成对调用 on 与 off。
- 用准确的触摸事件类型描述处理参数。
- 验证停用、恢复与销毁时的监听行为。
明确监听有效的时间范围
本例要求组件启用时响应触摸,停用时不响应,所以使用 onEnable 注册、onDisable 解除。若监听只在销毁时解除,组件停用期间可能仍接收来自外部对象的消息。监听的所有权与组件的活动范围必须对应,而不是只关注最终销毁。
on 与 off 要使用相同事件类型、相同回调引用和相同 target。临时箭头函数或每次调用 bind 都会生成新函数,解绑时再次生成一个“长得一样”的函数并不能对应原订阅。方法引用加 this 参数便于在生命周期两侧保持身份一致。
给 UI 节点挂一个触摸计数器
文件:TapCounter.ts,片段示例,依赖 Creator 3.8 的 UI 节点上下文。
import { _decorator, Component, Node, EventTouch } from 'cc';
const { ccclass } = _decorator;
@ccclass('TapCounter')
export class TapCounter extends Component {
private count = 0;
onEnable(): void {
this.node.on(Node.EventType.TOUCH_END, this.handleTap, this);
}
onDisable(): void {
// 三个参数与 on 一致,不能在这里重新 bind。
this.node.off(Node.EventType.TOUCH_END, this.handleTap, this);
}
private handleTap(event: EventTouch): void {
this.count += 1;
// 日志只记录业务次数,不持续刷帧日志。
console.log(`tap:${this.count}`);
}
}预期结果:场景 Canvas 下创建可见 UI Sprite 或按钮节点,确认有 UITransform,设置可点击尺寸,把 TapCounter 挂到同一节点。保存并预览,在节点范围内点击一次,控制台输出 tap:1。
用启停验证解绑
在预览调试上下文中将 TapCounter 的 enabled 设为 false,点击不应增加计数;再设为 true,点击一次应输出 tap:2。重复启停后一次点击仍只增加一。若只在编辑器停止预览后修改,再启动新预览,得到的是新实例,不能用它证明同一实例的解绑正确。
销毁启用组件时会经过停用清理,成对解绑使它不再保留节点监听。若注册的是长期存活的外部 EventTarget,这点更重要,否则对象可能通过回调引用被保留。清理不应粗暴调用 off(type) 移除别人的监听,而应仅解除本组件拥有的那一组参数。
事件能否到达是另一条链
Node 触摸事件依赖 UITransform,适用于 2D UI 节点。没有合适 UITransform、节点不在交互范围或被其他 UI 遮挡时,回调可能收不到。不要将本例原封不动挂到普通 3D 模型上,再把没有回调判为绑定失败。
触摸还可能经过传播过程,父节点也监听时,日志数量应结合监听对象分析。需要阻断传播时应根据具体 UI 规则设置事件行为,而不是为修复重复注册随意阻断所有事件。当前例子只在一个节点注册,先把单节点次数验证稳定。
让回调名称成为排查入口
明确命名的 handleTap 便于搜索注册与解除位置,日志也应包含业务次数或实例标识。若出现同一次点击多条日志,先核对场景是否有多个组件实例,再核对每个实例的注册次数,最后核对发布或传播次数。
触摸上下文依据 Cocos 3.8 Node 事件,成对解绑依据 事件监听与发射。稳定身份与明确有效范围是监听正确性的两个核心条件。