是否优先使用 image bitmap 来加载图片,启用之后,图片加载速度会更快, 但内存占用会变高,
已加载资源的集合, 你能通过 {{#crossLink "AssetManager/releaseAsset:method"}}{{/crossLink}} 来移除缓存
已加载 bundle 的集合, 你能通过 {{#crossLink "AssetManager/removeBundle:method"}}{{/crossLink}} 来移除缓存
是否缓存已加载的资源
缓存管理器是一个模块,在非 WEB 平台上,用于管理所有从服务器上下载下来的缓存
管理资源依赖关系
管理所有下载任务
下载管线
是否强制加载资源, 如果为 true ,加载资源将会忽略报错
管理所有合并后的资源
管理所有解析任务
正常加载管线
可选参数的预设集
Url 转换器
一些有用的方法
内置 main 包
内置 resources 包
获取已加载的分包
The name of bundle
初始化资源管理器
the configuration
通用加载资源接口,可传入进度回调以及完成回调,通过组合 request
和 options
参数,几乎可以实现和扩展所有想要的加载效果。非常建议
你使用更简单的API,例如 load
、loadDir
等。options
中的自定义参数将会分发到 requests
的每一项中,如果request中已存在同名的
参数则以 requests
中为准,同时如果有其他依赖资源,则 options
中的参数会继续向依赖项中分发。request中的自定义参数都会以 options
形式传入加载流程中的 downloader
, parser
的方法中, 你可以扩展 downloader
, parser
收集参数完成想实现的效果。
保留关键字: uuid
, url
, path
, dir
, scene
, type
, priority
, preset
, audioLoadMode
, ext
, bundle
, onFileProgress
,
maxConcurrency
, maxRequestsPerFrame
, maxRetryCount
, version
, xhrResponseType
, xhrWithCredentials
, xhrMimeType
, xhrTimeout
, xhrHeader
,
reloadAsset
, cacheAsset
, cacheEnabled
, 请不要使用这些字段为自定义参数!
The request you want to load
Optional parameters
Callback invoked when progression change
Callback invoked when finish loading
加载资源包
The name or root path of bundle
Some optional paramter, same like downloader.downloadFile
Callback when bundle loaded or failed
使用 url 加载远程资源,例如音频,图片,文本等等。
The url of asset
Some optional parameters
Callback invoked when finish loading
For internal usage.
加载资源的原生文件,如果你勾选了'延迟加载资源'选项,你可能需要在使用资源之前调用此方法来加载原生文件
The asset
Some optional parameters
Callback invoked when finish loading
通用预加载资源接口,可传入进度回调以及完成回调,非常建议你使用更简单的 API ,例如 preloadRes
, preloadResDir
等。preloadAny
和 loadAny
几乎一样,区别在于 preloadAny
只会下载资源,不会去解析资源,你需要调用 cc.assetManager.loadAny(preloadTask)
来完成资源加载。
The request you want to preload
Optional parameters
Callback invoked when progression change
Callback invoked when finish preloading
释放所有资源。详细信息请参考 {{#crossLink "AssetManager/releaseAsset:method"}}{{/crossLink}}
释放资源以及其依赖资源, 这个方法不仅会从 assetManager 中删除资源的缓存引用,还会清理它的资源内容。 比如说,当你释放一个 texture 资源,这个 texture 和它的 gl 贴图数据都会被释放。 注意,这个函数可能会导致资源贴图或资源所依赖的贴图不可用,如果场景中存在节点仍然依赖同样的贴图,它们可能会变黑并报 GL 错误。
The asset to be released
移除此包, 注意:这个包内的资源不会自动释放, 如果需要的话你可以在摧毁之前手动调用 {{#crossLink "Bundle/releaseAll:method"}}{{/crossLink}} 进行释放
The bundle to be removed
Generated using TypeDoc
此模块管理资源的行为和信息,包括加载,释放等,这是一个单例,所有成员能够通过
cc.assetManager
调用