游戏引擎 / 系统课时
远程资源怎样避免重复下载
远程资源怎样避免重复下载
头像、活动图和远程素材如果每次启动都重新下载,会同时增加首屏等待和移动流量。本课以 Cocos Creator 3.8 为例,区分请求合并、平台缓存和资源版本,建立可验证的复用策略。
学习目标
- 区分内存复用、Web HTTP 缓存和非 Web 平台的文件缓存。
- 用稳定的内容版本标识减少更新后的无效下载。
- 合并同一 URL 的并发请求,并验证实际传输量。
先定位重复发生在哪一层
同一启动周期内,多个界面可能同时索取同一张图片;重启游戏后,内存缓存消失;发布新版本后,如果所有资源 URL 都变化,未修改的文件也会重新下载。这三种现象需要分别处理。
assetManager 管理已加载资源。Web 平台的跨次访问缓存由浏览器及 HTTP 响应头决定;部分原生和小游戏平台可通过 assetManager.cacheManager 管理磁盘文件。磁盘命中只能省去传输,不代表图片无需解码或上传 GPU。

让内容版本决定缓存键
给可长期缓存的文件使用内容哈希命名,例如 avatar.a1b2c3.png;字节不变就沿用原 URL,文件改变才发布新名称。索引清单负责把业务资源名映射到当前文件 URL,清单本身应允许及时更新。不要在每次启动时拼接当前时间作为查询参数,否则会主动绕过复用。
Web/CDN 可为带哈希的静态文件配置较长的 Cache-Control 有效期和 immutable,并确保跨域图片有正确的 CORS 配置。若使用远程 Asset Bundle,应通过 Bundle 的版本及构建产物管理其配置和依赖,不要误以为普通 loadRemote 会自动比较服务器内容哈希。
合并同时发起的图片请求
以下脚本是 Cocos Creator 3.8 项目内可运行的组件。挂到节点后,在属性检查器中绑定目标 Sprite,并填入实际可访问的 PNG 地址;多个实例填同一 URL,用共享 Promise 合并尚未完成的请求。
import { _decorator, Component, Sprite, SpriteFrame,
Texture2D, ImageAsset, assetManager } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('RemoteSprite')
export class RemoteSprite extends Component {
@property(Sprite) target: Sprite | null = null;
@property({ type: String }) imageUrl = '';
private static pending = new Map<string, Promise<ImageAsset>>();
start(): void {
if (!this.target || !this.imageUrl) {
console.warn('请绑定 Sprite 并填写图片 URL');
return;
}
this.loadShared(this.imageUrl).then((image) => {
if (!this.target || !this.target.isValid) return;
// 下载资源可复用;每个显示组件持有自己的纹理与精灵帧。
const texture = new Texture2D();
texture.image = image;
const frame = new SpriteFrame();
frame.texture = texture;
this.target.spriteFrame = frame;
console.log('图片已显示');
}).catch((err) => console.error('图片加载失败', err));
}
private loadShared(url: string): Promise<ImageAsset> {
const active = RemoteSprite.pending.get(url);
if (active) return active;
// 仅合并进行中的请求;后续复用依赖资源管理器和平台缓存。
const task = new Promise<ImageAsset>((resolve, reject) => {
assetManager.loadRemote<ImageAsset>(
url, { ext: '.png', cacheEnabled: true }, (err, image) => {
if (err || !image) reject(err ?? new Error('图片数据为空'));
else resolve(image);
}
);
});
RemoteSprite.pending.set(url, task);
task.then(
() => RemoteSprite.pending.delete(url),
() => RemoteSprite.pending.delete(url)
);
return task;
}
}预期结果:地址有效且加载成功时,每个已绑定的组件都会显示图片,并输出:
图片已显示日志数量代表显示组件数,不代表网络下载次数。ext: '.png' 要与实际资源格式一致;上述 cacheEnabled 不能替代 Web 服务器的 HTTP 缓存配置。
处理依赖和失效边界
loadRemote 适用于远程图片、音频等原生文件,不负责解析完整的 Prefab、SpriteAtlas 依赖图。需要整套 Creator 资源和依赖时,应使用远程 Asset Bundle,并尽量只改变实际更新资源的版本标识。资源释放与下载缓存清理是两回事,不能通过每次启动调用 clearCache() 来解决更新问题。
少量损坏或过期文件可以在支持的平台上按原 URL 调用 cacheManager.removeCache(url)。旧版本淘汰应结合可用存储空间和平台策略处理,避免清理仍在使用的资源。
用真实传输数据验收
- 清空测试环境缓存,首次进入界面,记录资源请求数、实际传输字节和加载时间。
- 不改变资源 URL 再次进入,并重启应用复测;区分内存命中、浏览器磁盘命中或文件缓存命中。
- 只更新一张图片的内容哈希,检查未改变的 URL 是否继续复用,以及新 URL 是否正确获取新图。
Web 可看开发者工具的 Network 中传输大小与缓存来源;原生或小游戏需用对应真机日志、平台工具和 cacheManager 能力辅助确认。304 仍存在网络验证请求,不等于完全没有请求。最终以实际下载字节下降且图片版本正确为准。