找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/resource/ResourceInfo.ts
1/**
2 * 资源配置信息
3 */
4export interface ResourceInfo {
5 Name: string; //资源唯一名称(用于加载)
6 Path: string; //资源路径(相对于assets目录)
7 Bundle: string; //资源所属Bundle名称
8 InBundlePath: string; //资源所在的Bundle下的相对路径 用来加载Bundle内的资源
9 Type: string; //资源类型
10}
11
12export interface ResourceInfoJSON {
13 n: string; //资源唯一名称(用于加载)
14 p: string; //资源路径(相对于assets目录
15 i: string; //资源所在的Bundle下的相对路径 用来加载Bundle内的资源
16 t: string; //资源类型
17}
讲解17 行
资源清单条目结构人工通读

ResourceInfo.ts

定义运行期资源条目 ResourceInfo 与 JSON 清单的简写结构 ResourceInfoJSON,是资源管理器按名字索引资源、加载器拼 Bundle 内路径的唯一数据来源。

先看 ResourceInfo 五个字段,再看 JSON 版本的短键如何映射。

特殊处理与易错点

  • 易错点JSON 条目没有 Bundle 字段,解析时把外层对象的键当作 Bundle 名写入,键名写错会导致资源被派到错误包。
  • 设计真正传给 bundle.load 的是 InBundlePath,Path 只是相对 assets 的记录,加载时不被使用。
5属性资源唯一名称,作为加载与缓存的键。
6属性相对 assets 的资源路径,仅用于记录与排查。
7属性资源所属 Bundle 名称,决定去哪个包加载。
8属性资源在 Bundle 内的相对路径,加载器实际使用该字段。
9属性资源类型字符串,如 Texture2D,由调用方决定是否使用。
13属性n(string):该模块的运行态字段。
14属性p(string):该模块的运行态字段。
15属性i(string):该模块的运行态字段。
16属性t(string):该模块的运行态字段。