游戏引擎 / 系统课时
加载进度条怎样做才真实
加载进度条怎样做才真实
进度条到 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。
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;
}
);
}
}预期输出(成功路径):
加载完成,首屏已创建预期结果:进度随实际资源完成回调变化,创建首屏后才设置为 100%,并隐藏加载遮罩。如果首屏还要等待账号验证、在线配置或首次数据渲染,就应在那些工作完成的事件里再设置 100%,不能直接照搬本例的完成位置。
验证慢网与失败路径
在真机上分别测试首次下载、已有缓存、低带宽、临时断网和请求失败;记录从开始加载到首屏可操作的总耗时,并观察是否出现进度回退、提前满格或长时间无解释的停顿。失败时保持当前进度和错误文案,提供用户可触发的重试入口;重试时应重新开始对应任务,而不是只把数字清零。
如需衡量进度是否“真实”,不要只看数字是否均匀增长,而要检查最后一个完成事件是否与首屏实际可用相吻合。必要时宁可明确展示当前阶段,也不要伪造持续增长的百分比。