游戏引擎 / 系统课时
让按钮触发游戏动作
让按钮触发游戏动作
本课把主菜单的“开始”按钮连接到可验证的游戏动作:点击后隐藏菜单、更新状态文字,并且只记录一次启动日志。你将使用 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,内容如下。它不依赖任何其他课程的脚本,保存后等待编辑器完成编译。
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('游戏已开始');
}
}预期结果(完成下一节的节点引用和点击事件绑定后):点击“开始”,菜单消失,界面显示“游戏已开始”,控制台由此脚本输出一次:
游戏已开始@property 让节点引用暴露在属性检查器中;onStartClicked 才是 Click Events 要调用的方法。这里的布尔保护用于避免一次启动动作被连续点击重复执行,实际项目可以在同一入口进一步通知游戏状态管理器。
在编辑器中连接 Click Events
先把 MenuActions 挂到 GameUI,再将 StartPanel 拖到 menuPanel 属性,将 StatusLabel 节点上的 Label 组件对应到 statusLabel 属性。引用不填时示例虽不会抛出空引用错误,却无法完成全部可见效果。
选中 StartButton,在属性检查器的 Button 组件里找到 Click Events,新增一条事件并依次设置:
- 事件的目标节点选择
GameUI。 Component选择MenuActions。Handler选择onStartClicked,CustomEventData保持为空。

按钮自身的视觉 Target 用于控制颜色、缩放等过渡效果,不要与 Click Events 中指定回调接收者的目标节点混淆。点击事件通常在按钮按下后释放时触发;如果移出按钮区域后取消点击,就不应执行开始动作。
预览和定位无响应问题
保存场景并启动预览,从“等待开始”状态点击按钮,核对菜单隐藏、文字变化与日志是否同时出现。然后逐项排查:
- 点击没有效果:确认按钮及其父节点处于激活状态,
Interactable为开启,UITransform 的可点击区域覆盖按钮。 - 找不到回调方法:确认
MenuActions已成功编译并挂在事件目标GameUI上,再重新选择 Component 和 Handler。 - 日志有了但界面没变化:检查
menuPanel是否引用StartPanel、statusLabel是否引用正确的 Label,且StatusLabel没放在即将隐藏的菜单中。 - 动作执行了多次:检查 Click Events 是否重复配置,或是否又在代码里为同一按钮注册了其他点击监听。
对于场景中固定存在的菜单按钮,编辑器配置的 Click Events 简单直观;运行时动态创建的按钮可以改用代码监听,但应在相应生命周期解除监听。按钮只负责表达玩家意图,真正的开始、暂停或退出规则应集中到脚本方法处理。