游戏引擎 / 系统课时
从菜单切换到游戏场景
从菜单切换到游戏场景
场景切换会加载资源并替换当前场景,不是简单隐藏菜单节点。本节让菜单按钮进入 Game 场景,处理连续点击与加载失败,并把编辑器预览和发布构建的场景配置分开验证。
学习目标
- 使用场景名调用 director.loadScene
- 在加载期间锁定切换入口
- 验证场景是否进入构建列表
准备两个可区分的场景
创建并保存 Menu.scene 与 Game.scene。Menu 放一个开始按钮,Game 放文字 Game Ready,避免切换后两边画面完全一样而难以确认。在构建配置中加入两场景,初始场景选 Menu。场景引用应使用项目中可明确解析的唯一名称,本例为 Game。
在编辑器单独预览 Game,只能证明 Game 自身能运行;从 Menu 切换成功才证明导航入口已接通。发布包还必须验证构建列表,不能因为当前编辑器打开了 Game 就假定构建包含它。较大场景可先预加载以减少等待,但预加载本身不会切换活动场景。
把切换绑定到按钮
保存为 MenuSceneButton.ts,挂到 Menu 的 Button 节点。Button 的编辑器 Click Events 不再配置同一个方法。本组件用布尔标志和 interactable 双重限制重复入口,错误时允许重试。
import { _decorator, Component, Button, director } from 'cc';
const { ccclass } = _decorator;
@ccclass('MenuSceneButton')
export class MenuSceneButton extends Component {
private loading = false;
onEnable(): void { this.node.on(Button.EventType.CLICK, this.open, this); }
onDisable(): void { this.node.off(Button.EventType.CLICK, this.open, this); }
private open(): void {
const button = this.getComponent(Button);
if (this.loading || !button) return;
this.loading = true;
button.interactable = false; // 锁定重复点击
const failed = (error: unknown): void => {
console.error('scene-load-failed', error);
this.loading = false;
if (this.isValid && button.isValid) button.interactable = true;
};
const accepted = director.loadScene('Game', error => {
if (error) failed(error);
else console.log('scene:Game');
});
if (!accepted) failed('Request was not accepted');
}
}预期结果:点击开始后进入显示 Game Ready 的场景,日志出现 scene:Game。连续快速点击不应发起多次请求。故意把场景名改成不存在的名称时,应看到错误且能重新尝试;恢复正确名称后重新运行验证。
清理旧场景的关系
普通旧场景节点会在切换时销毁,挂在其上的监听和异步回调必须遵守生命周期。加载完成回调执行时,旧组件可能已经无效,因此不能在成功后继续修改旧菜单的 Label;需操作新场景时应通过新场景自己的初始化入口。
跨场景数据应由明确的会话对象保存,不要保留旧场景 Player 或按钮引用。加载失败时保留错误原因与目标场景名,分别检查名称、构建收录、资源加载和运行环境。开发预览与目标构建都至少走一次 Menu→Game,才算完成这一条导航链路。