loader 中的资源加载器,默认情况下是最先加载的。
用于标识资源的类型,并确定如何加载此资源。
loader 中的资源下载程序,默认情况下是第二个加载的。
它用于下载带有多个处理程序的文件:纯文本,图像,脚本,音频,字体,uuid。
您可以使用 addDownloadHandlers 来添加自己的下载函数
获取一个新的 XMLHttpRequest 的实例。
loader 中的资源下载程序,默认情况下是第三个加载的。
它用于解析下载的内容及多个处理程序的文件:纯文本,图像,脚本,音频,字体,uuid。
您可以使用 addLoadHandlers 来添加自己的下载函数
loader 中的 md5 加载管道,如果项目没有使用 md5 构建,则此项可能不存在。
用于修改带有 md5 后缀的真实可下载的 URL 。
Loader 默认的进度回调函数,如果在调用 {{load}} 函数时没有指定进度回调函数的话,会调用默认进度回调函数。
LoadingItems 队列中的加载项状态,状态的值可能是 {{ItemState.WORKING}} | {{ItemState.COMPLETE}} | {{ItemState.ERROR}}
在 laoder 中找到资源的引用 id ,参数可以是资源对象、资源的 uuid 或者是资源的 url
获取资源的 uuid
为下载程序添加自定义支持的类型处理程序或修改现有的类型处理程序。
Handlers for corresponding type in a map
为加载程序添加自定义支持的类型处理程序或修改现有的类型处理程序。
Handlers for corresponding type in a map
添加一个新的 pipe 到 pipeline 尾部。
该 pipe 必须包含一个字符串类型 ‘id’ 和 ‘handle’ 函数,该 id 在 pipeline 必须是唯一标识。
The pipe to be appended
清空当前 pipeline,该函数将清理 items。
从一个源 item 向所有目标 item 复制它的 pipe 状态,用于避免重复通过部分 pipe。
当一个源 item 生成了一系列新的 items 时很有用,
你希望让这些新的依赖项进入 pipeline,但是又不希望它们通过源 item 已经经过的 pipe,
但是你可能希望他们源 item 已经通过并跳过所有 pipes,
这个时候就可以使用这个 API。
The source item
A single destination item or an array of destination items
让新的 item 流入 pipeline 中。
这里的每个 item 可以是一个简单字符串类型的 url 或者是一个对象,
如果它是一个对象的话,他必须要包含 ‘id’ 属性。
你也可以指定它的 ‘type’ 属性类型,默认情况下,该类型是 ‘url’ 的后缀名。
也通过添加一个 包含 ‘skips’ 属性的 item 对象,你就可以跳过 skips 中包含的 pipe。
该对象可以包含任何附加属性。
The {{IItem}} to be appended to the current pipeline
参考:{{Pipeline.flowInDeps}}
这个函数会在 item
完成了所有管道,它会被标记为 complete
并流出管线。
The item which is completed
The asset itself or the asset url or the asset uuid
根据 id 获取一个 item
The id of the item
The asset url, it should be related path without extension to the resources
folder.
If type is provided, the asset for correspond type will be returned
获取加载的总资源数量
使用 {{director}} 初始化
The director instance of engine
在给定的索引位置插入一个新的 pipe。
一个 pipe 必须包含一个字符串类型的 ‘id’ 和 ‘handle’ 函数,该 id 在 pipeline 必须是唯一标识。
The pipe to be inserted
The index to insert
返回指定的资源是否有被设置为自动释放,不论场景的“Auto Release Assets”如何设置。
参考:{{setAutoRelease}},{{setAutoReleaseRecursively}}
asset object or the raw asset's url
使用进度回调和完整回调加载资源。
进度回调与 Pipeline 的 LoadingItems.onProgress 相同
完整的回调与 Pipeline 的 LoadingItems.onComplete 几乎相同
唯一的区别是当用户将单个 URL 作为资源传递时,完整的回调将其结果直接设置为第二个参数。
Url list or load request list
Progression callback
Completion callback
从项目的 “assets” 文件夹下的 “resources” 文件夹中加载资源
注意:Creator 中的所有资源 URL 都使用正斜杠,使用反斜杠的 URL 将不起作用。
The url of the asset to be loaded, this url should be related path without file extension to the resources
folder.
If type is provided, only asset for correspond type will be loaded
Progression callback
Completion callback
此方法除了接受 URL 数组参数外,与 loadRes 方法相同。
If type is provided, only assets for correspond type will be loaded
Progression callback
Completion callback
将所有资产加载到项目 “assets / resources” 文件夹中
注意:Creator 中的所有资源 URL 都使用正斜杠,使用反斜杠的 URL 将不起作用。
The url of the directory to be loaded, this url should be related path to the resources
folder.
If type is provided, only assets for correspond type will be loaded
Progression callback
Completion callback
通过 id(通常是资源 url)来释放一个资源或者一个资源数组。
这个方法不仅会从 loader 中删除资源的缓存引用,还会清理它的资源内容。
比如说,当你释放一个 texture 资源,这个 texture 和它的 gl 贴图数据都会被释放。
在复杂项目中,我们建议你结合 getDependsRecursively 来使用,便于在设备内存告急的情况下更快地释放不再需要的资源的内存。
注意,这个函数可能会导致资源贴图或资源所依赖的贴图不可用,如果场景中存在节点仍然依赖同样的贴图,它们可能会变黑并报 GL 错误。
如果你只想删除一个资源的缓存引用,请使用 Pipeline.removeItem
释放所有资源。详细信息请参考 {{release}}
通过资源对象自身来释放资源。详细信息请参考 {{release}}
The asset to be released
释放通过 {{loadRes}} 加载的资源。详细信息请参考 {{release}}
The asset url, it should be related path without extension to the resources
folder.
If type is provided, the asset for correspond type will be returned
释放通过 {{loadResDir}} 加载的资源。详细信息请参考 {{release}}
The url of the directory to release, it should be related path to the resources
folder.
If type is provided, the asset for correspond type will be returned
设置当场景切换时是否自动释放资源。
默认情况下,当加载新场景时,旧场景的资源根据旧场景是否勾选“Auto Release Assets”,将会被释放或者保留。
而使用 loader.loadRes
或 loader.loadResDir
动态加载的资源,则不受场景设置的影响,默认不自动释放。
使用这个 API 可以在单个资源上改变这个默认行为,强制在切换场景时保留或者释放指定资源。
参考:{{setAutoReleaseRecursively}},{{isAutoRelease}}
The asset or its url or its uuid
Whether to release automatically during scene switch
设置当场景切换时是否自动释放资源及资源引用的其它资源。
默认情况下,当加载新场景时,旧场景的资源根据旧场景是否勾选“Auto Release Assets”,将会被释放或者保留。
而使用 loader.loadRes
或 loader.loadResDir
动态加载的资源,则不受场景设置的影响,默认不自动释放。
使用这个 API 可以在指定资源及资源递归引用到的所有资源上改变这个默认行为,强制在切换场景时保留或者释放指定资源。
参考:{{setAutoRelease}},{{isAutoRelease}}
The asset or its url or its uuid
Whether to release automatically during scene switch
Generated using TypeDoc
资源加载管理器,引擎会自动创建一个单例对象 {{loader}}。