可选参数

    为了增加灵活性和可扩展性，Asset Manager 中大部分的加载接口包括 和 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

    注意：请 不要 使用以上字段作为自定义参数的名称，避免与引擎功能发生冲突。

    可选参数 priority, maxConcurrency, maxRequestsPerFrame, maxRetryCount 分别用于控制下载器对于下载请求的优先级排序、下载并发数限制、每帧能发起的请求数限制、最大重试次数。

    下载器/解析器中的文本文件和二进制文件等资源的处理方法，可接受可选参数 xhrResponseType, , xhrMimeType, xhrTimeout, xhrHeader, onFileProgress 用于设置 XHR 的返回类型、头部以及下载进度回调等参数。

    1. // 获取 XHR 的下载进度回调
    2. assetManager.loadAny({
    3.     'path': 'image/background'
    4. },
    5. {
    6.     onFileProgress: function (loaded, total) {
    7.         console.log(loaded/total);
    8.     }
    9. }, callback);

    而可选参数 audioLoadMode 则用于控制音频文件的处理方法是否使用 WebAudio 来加载音频。

    注意：想要获取资源的加载进度必须在服务器端做好相关配置。

    可选参数 reload, cacheAsset, cacheEnabled 用于控制加载管线是否复用缓存中的资源、是否缓存资源、以及是否缓存文件。

    1. assetManager.loadRemote(url, {reload: true, cacheAsset: false, cacheEnabled: true}, (err, asset) => {});

    而可选参数 uuid, url, path, dir, scene, type, ext, bundle 等，则是用于搜索资源。

    这种方式完全等价于直接使用 resources.load 和 resources.loadDir。

    扩展引擎

    开发者可以通过在 和 自定义处理方法 中使用可选参数来扩展引擎的加载功能。

    1. // 扩展管线
    2. assetManager.pipeline.insert(function (task, done) {
    3.     for (let i = 0; i < input.length; i++) {
    4.         if (input[i].options.myParam === 'important') {
    6.         }
    7.     }
    8.     task.output = task.input;
    9.     done();
    10. }, 1);
    12. assetManager.loadAny({'path': 'images/background'}, {'myParam': 'important'}, callback);
    14. // 注册处理方法
    15. assetManager.downloader.register('.myformat', function (url, options, callback) {
    16.     // 下载对应资源
    17.     const img = new Image();
    18.     if (options.isCrossOrigin) {
    19.         img.crossOrigin = 'anonymous';
    21.     img.onload = function () {
    22.         callback(null, img);
    23.     };
    25.     img.onerror = function () {
    26.         callback(new Error('download failed'), null);
    27.     };
    29.     img.src = url;
    31. });
    33. assetManager.parser.register('.myformat', function (file, options, callback) {
    34.     // 解析下载完成的文件
    35.     callback(null, file);
    36. });
    37. assetManager.loadAny({'url': 'http://example.com/myAsset.myformat'}, {isCrossOrigin: true}, callback);