游戏引擎 / 系统课时

把按钮点击接到游戏逻辑

把按钮点击接到游戏逻辑

按钮能改变颜色不代表它已经调用游戏逻辑,重复绑定又可能让一次点击执行多次。本节用可见计数和按钮禁用证明事件接线,并让监听的拥有者负责清理。

学习目标

  • 通过 Button 点击事件调用组件方法
  • 用 interactable 阻止重复提交
  • 检查遮挡、绑定和监听重复

建立可交互的 UI

在 Canvas 下创建 Button 节点 StartButton 和 Label 节点 StatusLabel,确保按钮区域有 UITransform、Button 组件启用且节点激活。按钮的大小应覆盖可见点击区,相机可见层包含它;界面上的全屏遮挡节点可能先接到触摸。

本例采用脚本注册事件。若同时在 Button 的 Click Events 列表配置相同方法,一次点击会走两个入口,因此先清空该列表中的重复接线。项目应选定一种接线方式,并保留明确的调用路径。

让一次点击产生一个结果

保存为 StartButtonProbe.ts,挂到 Button 节点,把 StatusLabel 的 Label 组件拖入 status 属性。启用时重置演示状态,点击后锁定,停用时移除事件。

ts
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 是否使用同一方法。

当界面切换为不销毁的隐藏面板,监听也要随隐藏策略管理。这里使用组件生命周期,隐藏整个节点会触发停用;只把透明度调为零则不会自动移除事件,不能把透明等同于不可交互。

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

目录与阅读设置

阅读设置

17

记录一个想法

把按钮点击接到游戏逻辑

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

登录哪都通