游戏引擎 / 系统课时

让按钮触发游戏动作

让按钮触发游戏动作

本课把主菜单的“开始”按钮连接到可验证的游戏动作:点击后隐藏菜单、更新状态文字,并且只记录一次启动日志。你将使用 Cocos Creator 3.8 的 Button 点击事件,将界面交互交给独立脚本处理,而不是让按钮直接承载游戏规则。

学习目标

  • 说清 Button、事件目标节点与脚本回调之间的关系。
  • 在属性检查器里完成 Click Events 的绑定。
  • 验证按钮的可见效果,并定位常见的点击无响应问题。

准备菜单和反馈节点

在 Cocos Creator 3.8 的二维场景里创建一个 Canvas,并在其下安排四个节点:

  • StartPanel:菜单容器,初始为激活状态。
  • StartButton:作为 StartPanel 的子节点,添加 Button 组件,按钮文字为“开始”。
  • StatusLabel:与 StartPanel 平级,添加 Label 组件,初始文字为“等待开始”。
  • GameUI:与 StartPanel 平级的空节点,专门挂载处理界面动作的脚本。

确保 StartButton 有覆盖可视按钮区域的 UITransform,Button 的 Interactable 已开启。把状态文字放在菜单外,是为了隐藏菜单后仍能看见结果;把脚本放在独立的 GameUI 上,则避免菜单关闭时连带停用控制组件。

编写开始按钮的回调

在资源管理器中新建 TypeScript 脚本 MenuActions.ts,内容如下。它不依赖任何其他课程的脚本,保存后等待编辑器完成编译。

ts
import { _decorator, Component, Label, Node, log } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('MenuActions')
export class MenuActions extends Component {
    @property(Node)
    public menuPanel: Node | null = null;

    @property(Label)
    public statusLabel: Label | null = null;

    private started = false;

    public onStartClicked(): void {
        // 已开始时不再重复执行启动动作。
        if (this.started) return;
        this.started = true;

        // 菜单与反馈文字分属不同节点。
        if (this.menuPanel) this.menuPanel.active = false;
        if (this.statusLabel) this.statusLabel.string = '游戏已开始';
        log('游戏已开始');
    }
}

预期结果(完成下一节的节点引用和点击事件绑定后):点击“开始”,菜单消失,界面显示“游戏已开始”,控制台由此脚本输出一次:

text
游戏已开始

@property 让节点引用暴露在属性检查器中;onStartClicked 才是 Click Events 要调用的方法。这里的布尔保护用于避免一次启动动作被连续点击重复执行,实际项目可以在同一入口进一步通知游戏状态管理器。

在编辑器中连接 Click Events

先把 MenuActions 挂到 GameUI,再将 StartPanel 拖到 menuPanel 属性,将 StatusLabel 节点上的 Label 组件对应到 statusLabel 属性。引用不填时示例虽不会抛出空引用错误,却无法完成全部可见效果。

选中 StartButton,在属性检查器的 Button 组件里找到 Click Events,新增一条事件并依次设置:

  1. 事件的目标节点选择 GameUI。
  2. Component 选择 MenuActions。
  3. Handler 选择 onStartClicked,CustomEventData 保持为空。

Button 点击事件的目标节点与回调绑定位置

按钮自身的视觉 Target 用于控制颜色、缩放等过渡效果,不要与 Click Events 中指定回调接收者的目标节点混淆。点击事件通常在按钮按下后释放时触发;如果移出按钮区域后取消点击,就不应执行开始动作。

预览和定位无响应问题

保存场景并启动预览,从“等待开始”状态点击按钮,核对菜单隐藏、文字变化与日志是否同时出现。然后逐项排查:

  • 点击没有效果:确认按钮及其父节点处于激活状态,Interactable 为开启,UITransform 的可点击区域覆盖按钮。
  • 找不到回调方法:确认 MenuActions 已成功编译并挂在事件目标 GameUI 上,再重新选择 Component 和 Handler。
  • 日志有了但界面没变化:检查 menuPanel 是否引用 StartPanel、statusLabel 是否引用正确的 Label,且 StatusLabel 没放在即将隐藏的菜单中。
  • 动作执行了多次:检查 Click Events 是否重复配置,或是否又在代码里为同一按钮注册了其他点击监听。

对于场景中固定存在的菜单按钮,编辑器配置的 Click Events 简单直观;运行时动态创建的按钮可以改用代码监听,但应在相应生命周期解除监听。按钮只负责表达玩家意图,真正的开始、暂停或退出规则应集中到脚本方法处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

让按钮触发游戏动作

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

登录哪都通