cc.loader 中的资源加载器,默认情况下是最先加载的。
用于标识资源的类型,并确定如何加载此资源。
cc.loader 中的资源下载程序,默认情况下是第二个加载的。
它用于下载带有多个处理程序的文件:纯文本,图像,脚本,音频,字体,uuid。
您可以使用 addDownloadHandlers 来添加自己的下载函数
获取一个新的 XMLHttpRequest 的实例。
cc.loader 中的资源下载程序,默认情况下是第三个加载的。
它用于解析下载的内容及多个处理程序的文件:纯文本,图像,脚本,音频,字体,uuid。
您可以使用 addLoadHandlers 来添加自己的下载函数
cc.loader 中的 md5 加载管道,如果项目没有使用 md5 构建,则此项可能不存在。
用于修改带有 md5 后缀的真实可下载的 URL 。
在 laoder 中找到资源的引用 id ,参数可以是资源对象、资源的 uuid 或者是资源的 url
获取资源的 uuid
通过uuids 加载资源
arguments
当 url 未找到时的操作
为下载程序添加自定义支持的类型处理程序或修改现有的类型处理程序。
具有相应处理程序的自定义支持类型
为加载程序添加自定义支持的类型处理程序或修改现有的类型处理程序。
具有相应处理程序的自定义支持类型
添加一个新的 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。
该对象可以包含任何附加属性。
资源本身或者是资源的 url 或者是资源的 uuid
根据 id 获取一个 item
The id of the item
如果提供此参数,则将仅返回此类型的资源。
获取加载的总资源数量
在给定的索引位置插入一个新的 pipe。
一个 pipe 必须包含一个字符串类型的 ‘id’ 和 ‘handle’ 函数,该 id 在 pipeline 必须是唯一标识。
The pipe to be inserted
The index to insert
在当前 pipeline 的一个已知 pipe 后面插入一个新的 pipe。
An existing pipe in the pipeline.
The pipe to be inserted.
返回指定的资源是否有被设置为自动释放,不论场景的“Auto Release Assets”如何设置。
参考:setAutoRelease,setAutoReleaseRecursively
asset object or the raw asset's url
使用进度回调和完整回调加载资源。
进度回调与 Pipeline 的 LoadingItems.onProgress 相同
完整的回调与 Pipeline 的 LoadingItems.onComplete 几乎相同
唯一的区别是当用户将单个 URL 作为资源传递时,完整的回调将其结果直接设置为第二个参数。
Url 列表数组
当进度改变时调用的回调函数
当所有资源加载完毕后调用的回调函数
目标资源的 URL
URl 相对于 “resources” 文件夹,必须省略文件扩展名。
如果提供此参数,则将仅加载此类型的资源。
当进度改变时调用的回调函数
当所有资源加载完毕后调用的回调函数
目标资源的 URL
URl 相对于 “resources” 文件夹,必须省略文件扩展名。
如果提供此参数,则将仅加载此类型的资源。
当进度改变时调用的回调函数
当所有资源加载完毕后调用的回调函数
目标资源的 URL
URl 相对于 “resources” 文件夹,必须省略文件扩展名。
如果提供此参数,则将仅加载此类型的资源。
当所有资源加载完毕后调用的回调函数
此方法除了接受 URL 数组参数外,与 loadRes 方法相同。
目标资源的 URL 数组。 URl 为相对于 “resources” 文件夹的,且必须省略文件扩展名。
如果提供此参数,则将仅加载此类型的资源。
当进度改变时调用的回调函数
当所有资源加载完毕后或者发生错误时调用的回调函数
将所有资产加载到项目 “assets / resources” 文件夹中
注意:Creator 中的所有资源 URL 都使用正斜杠,使用反斜杠的 URL 将不起作用。
目标文件夹的 URL
URl 相对于 “resources” 文件夹,必须省略文件扩展名。
如果提供此参数,则将仅加载此类型的资源。
当进度改变时调用的回调函数
当所有资源加载完毕后或者发生错误时调用的回调函数
通过 id(通常是资源 url)来释放一个资源或者一个资源数组。
从 v1.3 开始,这个方法不仅会从 loader 中删除资源的缓存引用,还会清理它的资源内容。
比如说,当你释放一个 texture 资源,这个 texture 和它的 gl 贴图数据都会被释放。
在复杂项目中,我们建议你结合 getDependsRecursively 来使用,便于在设备内存告急的情况下更快地释放不再需要的资源的内存。
注意,这个函数可能会导致资源贴图或资源所依赖的贴图不可用,如果场景中存在节点仍然依赖同样的贴图,它们可能会变黑并报 GL 错误。
如果你只想删除一个资源的缓存引用,请使用 Pipeline.removeItem
释放所有资源。详细信息请参考 release
如果提供此参数,则将仅释放此类型的资源。
释放通过 loadResDir 加载的资源。详细信息请参考 release
如果提供此参数,则将仅释放此类型的资源。
设置当场景切换时是否自动释放资源。
默认情况下,当加载新场景时,旧场景的资源根据旧场景是否勾选“Auto Release Assets”,将会被释放或者保留。
而使用 cc.loader.loadRes
或 cc.loader.loadResDir
动态加载的资源,则不受场景设置的影响,默认不自动释放。
使用这个 API 可以在单个资源上改变这个默认行为,强制在切换场景时保留或者释放指定资源。
参考:setAutoReleaseRecursively,isAutoRelease
资源对象或原始资源的 URL 或是 UUID
表示是否自动释放
设置当场景切换时是否自动释放资源及资源引用的其它资源。
默认情况下,当加载新场景时,旧场景的资源根据旧场景是否勾选“Auto Release Assets”,将会被释放或者保留。
而使用 cc.loader.loadRes
或 cc.loader.loadResDir
动态加载的资源,则不受场景设置的影响,默认不自动释放。
使用这个 API 可以在指定资源及资源递归引用到的所有资源上改变这个默认行为,强制在切换场景时保留或者释放指定资源。
参考:setAutoRelease,isAutoRelease
资源对象或原始资源的 URL 或是 UUID
表示是否自动释放
Generated using TypeDoc
资源加载程序,这是一个单例对象。