游戏引擎 / 系统课时
给场景切换加上流程保护
给场景切换加上流程保护
连续点击开始按钮时,两个准备流程可能同时加载场景,失败后按钮也可能一直锁住。本节把准备、预加载和启动拆成有顺序的流程,使用忙碌标记与失效版本控制提交,再核对 Cocos 场景 API 的回调位置与立即失败返回值。
学习目标
- 为重复触发、准备失败与离开入口建立明确策略。
- 在预加载成功后再启动场景,识别立即拒绝与异步失败。
- 验证流程保护的业务规则与真实引擎接入范围。
保护的是一次提交过程
这里选择忙碌期间拒绝后续点击,失败后允许重试。流程依次准备业务数据、预加载场景、检查请求仍有效、启动场景。预加载只准备资源,不会自动运行场景。一个状态对象管理全过程,避免每个回调分别修改互相矛盾的按钮状态。
版本号防止已经离开的入口继续提交。检查点位于真正启动场景之前,启动一旦已被引擎接受,就不能把后续失效检查描述为撤销切换。等待结果与取消请求不是同一操作,场景提交需要尽早决定是否仍有效。

先运行流程规则
文件:flow.ts,完整纯 TypeScript 模块。
export class SwitchFlow {
private busy = false;
private version = 0;
constructor(
private prepare: () => Promise<void>,
private preload: () => Promise<void>,
private launch: () => Promise<void>,
) {}
invalidate(): void { this.version += 1; }
async enter(): Promise<string> {
if (this.busy) return 'busy';
this.busy = true;
const request = ++this.version;
try {
await this.prepare();
if (request !== this.version) return 'stale';
await this.preload();
// 最后一个失效检查在场景提交之前。
if (request !== this.version) return 'stale';
await this.launch();
return 'entered';
} catch (error: unknown) {
return error instanceof Error ? `failed:${error.message}` : 'failed:unknown';
} finally { this.busy = false; }
}
}模块由以下入口验证,三个依赖是流程夹具,不模拟引擎运行。文件:main.ts。
import { SwitchFlow } from './flow';
async function main(): Promise<void> {
let launches = 0;
let fail = false;
const flow = new SwitchFlow(
async () => { if (fail) throw new Error('prepare'); },
async () => {}, async () => { launches += 1; },
);
const first = flow.enter();
console.log(await flow.enter());
console.log(await first);
fail = true;
console.log(await flow.enter());
fail = false;
const old = flow.enter();
// 等待期间离开入口,旧流程不能提交。
flow.invalidate();
console.log(await old);
console.log(await flow.enter());
console.log(`launches:${launches}`);
}
void main().catch((error: unknown) => { throw error; });预期输出:
busy
entered
failed:prepare
stale
entered
launches:2接到正确的场景 API
文件:SceneEntry.ts,片段示例,依赖 Creator 3.8 与同目录 flow.ts。场景名 Arena 必须存在并纳入可加载场景配置。
import { _decorator, Component, Node, director } from 'cc';
import { SwitchFlow } from './flow';
const { ccclass } = _decorator;
function preloadArena(): Promise<void> {
return new Promise((resolve, reject) => {
// 三参数形式:第二参数进度,第三参数完成。
director.preloadScene('Arena', () => {}, error => {
if (error) reject(error); else resolve();
});
});
}
function launchArena(): Promise<void> {
return new Promise((resolve, reject) => {
const accepted = director.loadScene('Arena', error => {
if (error) reject(error); else resolve();
});
// false 是立即拒绝,不可只等一个不会到来的完成回调。
if (!accepted) reject(new Error('scene request rejected'));
});
}
@ccclass('SceneEntry')
export class SceneEntry extends Component {
private flow = new SwitchFlow(async () => {}, preloadArena, launchArena);
onEnable(): void { this.node.on(Node.EventType.TOUCH_END, this.enter, this); }
onDisable(): void {
this.node.off(Node.EventType.TOUCH_END, this.enter, this);
this.flow.invalidate();
}
private enter(): void {
// 完成后只打印结果,不再修改已经切换掉的旧场景 UI。
void this.flow.enter().then(result => console.log(result));
}
}预期结果:创建 Start 与 Arena 两个场景,将 Arena 加入构建场景列表;Start 的 Canvas 下创建可点击 UI 节点并挂 SceneEntry,确认 UITransform 尺寸。保存、预览 Start 后点击,成功会运行 Arena。连续点击期间只接受一次流程,其余返回 busy。
验收失败与离开入口
改成不存在的场景名,预加载应失败并恢复忙碌状态;修复后重新预览可再次进入。若停用入口发生在提交前,旧流程返回 stale,不应调用 loadScene。真正场景启动会销毁旧场景组件,因此不能在完成后访问旧 Label 或按钮引用。
业务 prepare 在接入片段中为空,这是明确的最小场景切换上下文。需要登录数据或关卡配置时,把真实准备函数注入同一 SwitchFlow,失败仍走同一出口。不要把“预加载成功”记为“玩家已进入场景”,这两个事件的时间与失败原因不同。
loadScene 返回 true 只表示请求被接受,并不保证场景最终成功启动;异步错误仍通过完成回调返回。因此包装函数同时检查布尔值和回调错误。立即拒绝时若只等回调,整个流程可能保持等待,finally 也无法自动执行,按钮就一直被锁住。
回归时应分开制造准备失败、预加载失败和启动失败,而不是只改一个场景名就宣称三层都覆盖。纯流程夹具可以让注入函数分别拒绝,Creator 中则根据真实场景配置观察实际错误。输入被拒绝时也应保留原场景,不要提前删除入口节点或清空业务状态。
若某依赖永久等待,本例仍会保持忙碌;Promise 并不保证一定结束。需要超时策略时,应明确等待截止、用户重试与旧结果归属,不能把超时包装误认为取消引擎加载。当前例程只处理已结束的成功和失败,以及提交前失效,不承诺撤回已经接受的切换。
本例覆盖流程重复、失败恢复和提交前失效;引擎的图形切换仍需实际 Creator 验证。API 参数、布尔返回与回调依据 Cocos 3.8 Director API 和 3.8.7 Director 实现,使用说明见 场景加载与切换。