游戏引擎 / 系统课时
把按钮点击接到游戏逻辑
把按钮点击接到游戏逻辑
按钮能改变颜色不代表它已经调用游戏逻辑,重复绑定又可能让一次点击执行多次。本节用可见计数和按钮禁用证明事件接线,并让监听的拥有者负责清理。
学习目标
- 通过 Button 点击事件调用组件方法
- 用 interactable 阻止重复提交
- 检查遮挡、绑定和监听重复
建立可交互的 UI
在 Canvas 下创建 Button 节点 StartButton 和 Label 节点 StatusLabel,确保按钮区域有 UITransform、Button 组件启用且节点激活。按钮的大小应覆盖可见点击区,相机可见层包含它;界面上的全屏遮挡节点可能先接到触摸。
本例采用脚本注册事件。若同时在 Button 的 Click Events 列表配置相同方法,一次点击会走两个入口,因此先清空该列表中的重复接线。项目应选定一种接线方式,并保留明确的调用路径。
让一次点击产生一个结果
保存为 StartButtonProbe.ts,挂到 Button 节点,把 StatusLabel 的 Label 组件拖入 status 属性。启用时重置演示状态,点击后锁定,停用时移除事件。
import { _decorator, Component, Button, Label } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('StartButtonProbe')
export class StartButtonProbe extends Component {
@property(Label) status: Label | null = null;
private button: Button | null = null;
onEnable(): void {
this.button = this.getComponent(Button);
if (!this.button || !this.status) { this.enabled = false; return; }
this.button.interactable = true;
this.status.string = 'Ready';
this.node.on(Button.EventType.CLICK, this.clicked, this);
}
onDisable(): void {
this.node.off(Button.EventType.CLICK, this.clicked, this);
}
private clicked(): void {
if (!this.button?.interactable || !this.status) return;
this.button.interactable = false; // 先锁定,再执行本次操作
this.status.string = 'Started:1';
console.log('start:1'); // 真实游戏在这里向流程控制器发出意图
}
}预期结果:启动显示 Ready,第一次完整点击后变为 Started:1,日志出现一次 start:1;按钮变为不可交互,连续点击不会新增日志。停用再启用组件后回到 Ready,可以重新完成一次。
区分交互锁与业务校验
interactable 是界面状态,不能代替流程控制器的合法状态检查。网络请求期间锁按钮可以降低误触,但服务端幂等和请求身份仍要由业务层处理。失败时是否恢复按钮、恢复什么文字,应由明确结果决定,不能在任意延时后假定成功。
按钮完全没反应时,先检查激活、组件启用、可交互、命中区域和遮挡,再检查事件方法是否被注册。有日志但游戏没开始,则追踪流程调用和目标状态;不要继续改触摸区域。一按执行多次时,查脚本重复挂载、编辑器接线与代码双重绑定,以及 on/off 是否使用同一方法。
当界面切换为不销毁的隐藏面板,监听也要随隐藏策略管理。这里使用组件生命周期,隐藏整个节点会触发停用;只把透明度调为零则不会自动移除事件,不能把透明等同于不可交互。