游戏引擎 / 系统课时

加载进度条怎样做才真实

加载进度条怎样做才真实

进度条到 100% 后仍停在加载页,往往是因为只计算了资源项完成数量,却没有把界面创建和首屏就绪算进去。本课将真实回调与加载阶段对应起来,让玩家既看得到进展,也不会被虚假的完成状态误导。

学习目标

  • 区分资源项完成率、下载字节进度与真正的首屏就绪。
  • 根据实测耗时为各阶段分配进度区间,避免过早达到 100%。
  • 使用 Cocos Creator 3.8 的资源回调驱动进度条并处理失败。

先明确完成标准

在移动游戏中,“资源下载完成”不等于“玩家可以操作”。资源可能还需要依赖加载、解析、预制体实例化,甚至等待必要的在线配置。如果只把资源加载回调的 finished / total 直接当作全局百分比,后续工作就会在 100% 之后继续发生。

Cocos Creator 3.8 的 resources.load 与 resources.loadDir 支持 onProgress(finished, total, item)。这里的计数代表资源加载任务项,不代表下载字节或剩余时间;大纹理和小配置文件对计数的影响可能相同。最终完成应以所有首屏必要工作成功且界面可用为准。

将阶段映射到进度区间

先在目标机型上记录关键资源加载、界面构建、必要初始化各自的耗时,再用多次测试的典型值决定权重。例如一条较简单的首屏链路可以把资源加载映射到 0%~85%,将预制体创建和展示映射到 85%~100%。85% 只是示例,不是引擎内置比例;如果联网初始化占了较长时间,就需要为它单独预留区间。

资源完成率到首屏就绪的进度映射

显示值可以适度平滑,但不得超过真实已验证的目标进度。total 可能随着依赖发现而变化,要避免显示值回退;遇到长时间无更新时,改为显示“正在连接”或“加载较慢”,不要用固定计时器把数字推到 99%。

用加载回调实现最小首屏

在 assets/resources/startup/ 下准备 main-panel.prefab,其中包含可直接交互的首屏 UI,且没有额外的异步初始化。在加载场景中放置一个单独的加载遮罩节点,挂载以下脚本并绑定 ProgressBar、Label;再将遮罩外的 UI 容器拖给 contentRoot。

ts
import { _decorator, Component, Node, ProgressBar, Label, Prefab, instantiate, resources } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('LoadingProgress')
export class LoadingProgress extends Component {
    @property(ProgressBar) bar: ProgressBar | null = null;
    @property(Label) hint: Label | null = null;
    @property(Node) contentRoot: Node | null = null;

    start() {
        const { bar, hint, contentRoot } = this;
        if (!bar || !hint || !contentRoot) {
            console.error('缺少加载界面引用');
            return;
        }

        bar.progress = 0;
        hint.string = '正在准备首屏资源';
        let settled = false;

        // 长时间无结果只更新文案,不虚增百分比
        this.scheduleOnce(() => {
            if (!settled) hint.string = '加载较慢,请检查网络';
        }, 8);

        resources.load('startup/main-panel', Prefab,
            (finished, total) => {
                const ratio = total > 0 ? finished / total : 0;
                // 完成项可能动态增加,用单调值避免进度回退
                bar.progress = Math.max(bar.progress, Math.min(0.85, ratio * 0.85));
            },
            (err, prefab) => {
                settled = true;
                if (err || !prefab) {
                    hint.string = '加载失败,请重试';
                    console.error('首屏资源失败', err);
                    return;
                }

                bar.progress = 0.85;
                // 本例只有同步预制体创建;有异步依赖时须继续等待就绪事件
                const view = instantiate(prefab);
                contentRoot.addChild(view);
                bar.progress = 1;
                hint.string = '首屏已就绪';
                console.log('加载完成,首屏已创建');
                this.node.active = false;
            }
        );
    }
}

预期输出(成功路径):

text
加载完成,首屏已创建

预期结果:进度随实际资源完成回调变化,创建首屏后才设置为 100%,并隐藏加载遮罩。如果首屏还要等待账号验证、在线配置或首次数据渲染,就应在那些工作完成的事件里再设置 100%,不能直接照搬本例的完成位置。

验证慢网与失败路径

在真机上分别测试首次下载、已有缓存、低带宽、临时断网和请求失败;记录从开始加载到首屏可操作的总耗时,并观察是否出现进度回退、提前满格或长时间无解释的停顿。失败时保持当前进度和错误文案,提供用户可触发的重试入口;重试时应重新开始对应任务,而不是只把数字清零。

如需衡量进度是否“真实”,不要只看数字是否均匀增长,而要检查最后一个完成事件是否与首屏实际可用相吻合。必要时宁可明确展示当前阶段,也不要伪造持续增长的百分比。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载进度条怎样做才真实

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

登录哪都通