找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/resource/ResourceBundleInfo.ts
1import {AssetManager} from 'cc';
2
3/**
4 * AssetBundle的信息
5 */
6export interface ResourceBundleInfo {
7 Name: string; //bundle的名字
8 Bundle: AssetManager.Bundle | null; //已经加载的Bundle实例
9 IsDownloaded: boolean; //是否已经下载
10 DownloadPromise: Promise<void> | null; //下载Promise (防止重复下载)
11}
讲解12 行
Bundle 缓存信息结构人工通读

ResourceBundleInfo.ts

定义 ResourceBundleLoader 缓存中每个 Bundle 的数据形状,记录名称、引擎 Bundle 实例、下载完成标记和共用下载 Promise。加载去重与失败清理都依赖这些字段。

先看 DownloadPromise 字段,再读 ResourceBundleLoader.LoadBundleByPath 如何写入这些字段。

特殊处理与易错点

  • 异步竞态DownloadPromise 让并发请求等待同一份下载结果,避免同名 Bundle 被重复 loadBundle。
  • 易错点Bundle 为 null 表示尚未加载成功,调用方取到缓存对象后仍需判断 Bundle 是否为空。
6注释AssetBundle的信息
7属性Bundle 名称,作为缓存与日志标识。
8属性引擎已加载的 Bundle 实例,加载成功后写入,未加载或失败时为 null。
9属性本次下载是否成功,失败时被重置为 false。