游戏引擎 / 系统课时

远程资源怎样避免重复下载

远程资源怎样避免重复下载

头像、活动图和远程素材如果每次启动都重新下载,会同时增加首屏等待和移动流量。本课以 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 合并尚未完成的请求。

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

预期结果:地址有效且加载成功时,每个已绑定的组件都会显示图片,并输出:

text
图片已显示

日志数量代表显示组件数,不代表网络下载次数。ext: '.png' 要与实际资源格式一致;上述 cacheEnabled 不能替代 Web 服务器的 HTTP 缓存配置。

处理依赖和失效边界

loadRemote 适用于远程图片、音频等原生文件,不负责解析完整的 Prefab、SpriteAtlas 依赖图。需要整套 Creator 资源和依赖时,应使用远程 Asset Bundle,并尽量只改变实际更新资源的版本标识。资源释放与下载缓存清理是两回事,不能通过每次启动调用 clearCache() 来解决更新问题。

少量损坏或过期文件可以在支持的平台上按原 URL 调用 cacheManager.removeCache(url)。旧版本淘汰应结合可用存储空间和平台策略处理,避免清理仍在使用的资源。

用真实传输数据验收

  1. 清空测试环境缓存,首次进入界面,记录资源请求数、实际传输字节和加载时间。
  2. 不改变资源 URL 再次进入,并重启应用复测;区分内存命中、浏览器磁盘命中或文件缓存命中。
  3. 只更新一张图片的内容哈希,检查未改变的 URL 是否继续复用,以及新 URL 是否正确获取新图。

Web 可看开发者工具的 Network 中传输大小与缓存来源;原生或小游戏需用对应真机日志、平台工具和 cacheManager 能力辅助确认。304 仍存在网络验证请求,不等于完全没有请求。最终以实际下载字节下降且图片版本正确为准。

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

目录与阅读设置

阅读设置

17

记录一个想法

远程资源怎样避免重复下载

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

登录哪都通