游戏引擎 / 系统课时

给场景切换加上流程保护

给场景切换加上流程保护

连续点击开始按钮时,两个准备流程可能同时加载场景,失败后按钮也可能一直锁住。本节把准备、预加载和启动拆成有顺序的流程,使用忙碌标记与失效版本控制提交,再核对 Cocos 场景 API 的回调位置与立即失败返回值。

学习目标

  • 为重复触发、准备失败与离开入口建立明确策略。
  • 在预加载成功后再启动场景,识别立即拒绝与异步失败。
  • 验证流程保护的业务规则与真实引擎接入范围。

保护的是一次提交过程

这里选择忙碌期间拒绝后续点击,失败后允许重试。流程依次准备业务数据、预加载场景、检查请求仍有效、启动场景。预加载只准备资源,不会自动运行场景。一个状态对象管理全过程,避免每个回调分别修改互相矛盾的按钮状态。

版本号防止已经离开的入口继续提交。检查点位于真正启动场景之前,启动一旦已被引擎接受,就不能把后续失效检查描述为撤销切换。等待结果与取消请求不是同一操作,场景提交需要尽早决定是否仍有效。

受保护的场景切换

先运行流程规则

文件:flow.ts,完整纯 TypeScript 模块。

ts
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。

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; });

预期输出:

text
busy
entered
failed:prepare
stale
entered
launches:2

接到正确的场景 API

文件:SceneEntry.ts,片段示例,依赖 Creator 3.8 与同目录 flow.ts。场景名 Arena 必须存在并纳入可加载场景配置。

ts
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 实现,使用说明见 场景加载与切换。

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

目录与阅读设置

阅读设置

17

记录一个想法

给场景切换加上流程保护

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

登录哪都通