Cocos Creator
可选参数
文:Santy-Wang,Xunyi
为了增加灵活性和可扩展性,Asset Manager 中大部分的加载接口包括 assetManager.loadAny
和 assetManager.preloadAny
都提供了 options
参数。options
除了可以配置 Creator 的内置参数,还可以自定义任意参数用于扩展引擎功能。如果开发者不需要配置引擎内置参数或者扩展引擎功能,可以无视它,直接使用更简单的 API 接口,比如 resources.load
。
目前 options
中引擎已使用的参数包括:
uuid
, url
, path
, dir
, scene
, type
, priority
, preset
, audioLoadMode
, ext
, bundle
, onFileProgress
, maxConcurrency
, maxRequestsPerFrame
, maxRetryCount
, version
, xhrResponseType
, xhrWithCredentials
, xhrMimeType
, xhrTimeout
, xhrHeader
, reloadAsset
, cacheAsset
, cacheEnabled
注意:请 不要 使用以上字段作为自定义参数的名称,避免与引擎功能发生冲突。
扩展引擎
开发者可以通过在 管线 和 自定义处理方法 中使用可选参数来扩展引擎的加载功能。
typescript
// 扩展管线
assetManager.pipeline.insert(function (task, done) {
const input = task.input;
for (let i = 0; i < input.length; i++) {
if (input[i].options.myParam === 'important') {
console.log(input[i].url);
}
}
task.output = task.input;
done();
}, 1);
assetManager.loadAny({'path': 'images/background'}, {'myParam': 'important'}, callback);
// 注册处理方法
assetManager.downloader.register('.myformat', function (url, options, callback) {
// 下载对应资源
const img = new Image();
if (options.isCrossOrigin) {
img.crossOrigin = 'anonymous';
}
img.onload = function () {
callback(null, img);
};
img.onerror = function () {
callback(new Error('download failed'), null);
};
img.src = url;
});
assetManager.parser.register('.myformat', function (file, options, callback) {
// 解析下载完成的文件
callback(null, file);
});
assetManager.loadAny({'url': 'http://example.com/myAsset.myformat'}, {isCrossOrigin: true}, callback);
通过可选参数,再结合管线和自定义处理方法,引擎可以获得极大的扩展度。Asset Bundle 可以看做是使用可选参数扩展的第一个实例。