为了方便开发者加载多个模型，Babylon.js从1.14版本引入了AssetsManager类。
此类可用于将模型导入场景活加载文本和二进制文件。
注意：导入的模型具有旋转四元数设置，因此使用rotation设置旋转会发现会旋转到意想不到的位置，如果使用rotation请将rotationQuaternion设置为空。

使用AssetsManager

初始化和创建任务

要使用它，首先要先通过场景进行实例化：

var assetsManager = new BABYLON.AssetsManager(scene);

然后，可以通过管理器的addMeshTask方法添加任务：

var meshTask = assetsManager.addMeshTask("skull task", "", "scenes", "skull.babylon");

每个任务都有一个成功回调和错误回调：

meshTask.onSuccess = function (task) {
    task.loadedMeshes[0].position = BABYLON.Vector3.Zero();
}

meshTask.onError = function (task, message, exception) {
    console.log(message, exception);
}

你也可以使用相同的方式加载文本addTextFileTask和二进制文件addBinaryFileTask：

var textTask = assetsManager.addTextFileTask("text task", "msg.txt");
textTask.onSuccess = function(task) {
    console.log(task.text);
}

var binaryTask = assetsManager.addBinaryFileTask("binary task", "grass.jpg");
binaryTask.onSuccess = function (task) {
    // Do something with task.data
}

管理器也支持加载图像addImageTask：

var imageTask = assetsManager.addImageTask("image task", "img.jpg");
imageTask.onSuccess = function(task) {
    console.log(task.image.width);
}

管理器也可以通过addTextureTask来创建加载纹理任务：

var textureTask = assetsManager.addTextureTask("image task", "img.jpg");
textureTask.onSuccess = function(task) {
    material.diffuseTexture = task.texture;
}

任务状态和错误处理

每个任务都有一个状态对象，表示当前任务的执行状态。状态由枚举表示，BABYLON.AssetTaskState有4种状态：

• INIT – 在任务开始执行之前
• RUNNING – 当任务开始执行但尚未完成时
• DONE – 当任务成功完成执行时
• ERROR – 任务失败时

如果任务具有错误状态（BABYLON.AssetTaskState.ERROR），则将向该任务添加新对象：task.errorObject。错误对象定义了2个变量，两个都是可选的：

• message – 一个很快解释错误的字符串（例如“请求返回404”）
• exception – 如果在执行期间抛出异常，异常对象将包含堆栈跟踪信息

这样，通过管理器也可以访问错误：

assetsManager.onTaskErrorObservable.add(function(task) {
    console.log('task failed', task.errorObject.message, task.errorObject.exception);
});

管理器回调和观察者模式

管理器自身拥有四个回调：

• onFinish
• onProgress
• onTaskSuccess
• onTaskError

assetsManager.onProgress = function(remainingCount, totalCount, lastFinishedTask) {
    engine.loadingUIText = 'We are loading the scene. ' + remainingCount + ' out of ' + totalCount + ' items still need to be loaded.';
};

assetsManager.onFinish = function(tasks) {
    engine.runRenderLoop(function() {
        scene.render();
    });
};

管理器还允许你使用观察者回调来处理onFinish，onProgress，onTaskSuccess和onTaskError：

• onTaskSuccessObservable – 当单个任务成功完成时，将执行已注册的观察者回调。
• onTaskErrorObservable – 当单个任务失败时，将执行已注册的观察者回调。
• onProgressObservable – 当单个任务成功完成或失败时，将执行已注册的观察者回调。
• onTasksDoneObservable – 当所有任务执行完成（成功或失败！）时，将执行已注册的观察者回调

assetsManager.onTaskSuccessObservable.add(function(task) {
    console.log('task successful', task)
});

assetsManager.onTasksDoneObservable.add(function(tasks) {
    var errors = tasks.filter(function(task) {return task.taskState === BABYLON.AssetTaskState.ERROR});
    var successes = tasks.filter(function(task) {return task.taskState !== BABYLON.AssetTaskState.ERROR});
});

开始任务

设置好任务以后，开启必须调用开始：

assetsManager.load();

• 你可以在这里看到现场演示
• 这里是playground演示

可用任务

你可以使用管理器去实现加载7种类型数据的任务。
每个任务都使用以下属性扩展AbstractAssetTask类（并实现IAssetTask接口）：

onSuccess: (task: IAssetTask) => void;
onError: (task: IAssetTask, message?: string, exception?: any) => void;

isCompleted: boolean = false;
name: string;
taskState: AssetTaskState;
errorObject: { message?: string; exception?: any; };

注意，加载的任务数据类型必须与创建的任务数据类型对应。例如，CubeTextureAssetTask的构造函数签名采用与类BABYLON.CubeTexture相同的变量。变量的顺序可能会有所不同。

MeshAssetTask

MeshAssetTask用于加载外部的模型（.babylon，.obj，.gltf等）。
构造函数配置指定：

constructor(name: string, meshesNames: any, rootUrl: string, sceneFilename: string)

额外属性：

public loadedMeshes: Array<AbstractMesh>;
public loadedParticleSystems: Array<ParticleSystem>;
public loadedSkeletons: Array<Skeleton>;

TextFileAssetTask

用于异步加载（文本）文件。
构造函数配置指定：

constructor(name: string, url: string)

额外属性：

public url: string;
public text: string;

BinaryFileAssetTask

此任务用于加载二进制文件。它与TextFileAssetTask的主要区别在于数据将存储在ArrayBuffer中
构造函数配置指定：

constructor(name: string, url: string)

额外属性：

public url: string;
public data: ArrayBuffer;

ImageAssetTask

此功能将加载图像（.png，.jpg，.gif）。它将创建一个HTMLImageElement对象
构造函数配置指定：

constructor(name: string, url: string)

额外属性：

public url: string;
public image: HTMLImageElement;

TextureAssetTask

这将从提供​​的单个URL创建一个新的BABYLON.Texture。
构造函数配置指定：

constructor(name: string, url: string, noMipmap?: boolean, invertY?: boolean, samplingMode: number = BABYLON.Texture.TRILINEAR_SAMPLINGMODE)

额外属性：

public texture: Texture;

CubeTextureAssetTask

与TextureAssetTask相同，但对于立方体纹理
构造函数配置指定：

constructor(name: string, url: string, extensions?: string[], noMipmap?: boolean, files?: string[])

额外属性：

public texture: CubeTexture;

HDRCubeTextureAssetTask

与CubeTextureAssetTask相同，但适用于HDR立方体纹理
构造函数配置指定：

constructor(name: string, url: string, size?: number, noMipmap = false, generateHarmonics = true, useInGammaSpace = false, usePMREMGenerator = false)

额外属性：

public texture: HDRCubeTexture;

EquiRectangularCubeTextureAssetTask

与CubeTextureAssetTask相同，但对于Equirectangular立方体纹理
构造函数配置指定：

constructor(name: string, url: string, size: number, noMipmap = false, useInGammaSpace = true)

额外属性：

public texture: EquiRectangularCubeTexture;

使用加载屏幕

默认情况下，AssetsManager将在加载资源时显示加载屏幕：

如果要禁用加载屏幕，则必须设置useDefaultLoadingScreen为false：

assetsManager.useDefaultLoadingScreen = false;

如果ShowLoadingScreen设置为true（默认情况下），则在使用SceneLoader加载场景时也会显示加载屏幕。

BABYLON.SceneLoader.ShowLoadingScreen = false;

同样，您也可以使用以下功能手动显示或隐藏加载屏幕：

engine.displayLoadingUI();
engine.hideLoadingUI();

使用loadingUIText设置显示加载文本：

engine.loadingUIText = "text";

使用loadingUIBackgroundColor方法控制背景颜色：

engine.loadingUIBackgroundColor = "red";