LoadingManager - Verge3D 用户手册 - Soft8Soft
Description: 了解如何在使用 Verge3D 制作的交互式 3D 应用程序中使用 LoadingManager

# LoadingManager

其功能是处理并跟踪已加载和待处理的数据。如果未手动设置加强管理器，则会为加载器创建和使用默认全局实例加载器管理器 - 请参阅 DefaultLoadingManager.
一般来说，默认的加载管理器已足够使用了，但有时候也需要设置单独的加载器 - 例如，如果你想为对象和纹理显示单独的加载条。

## 代码示例

下面的例子将介绍，如何使用加载管理器来跟踪 OBJLoader 的加载进度流程。

`const manager = new v3d.LoadingManager(); manager.onStart = function(url, itemsLoaded, itemsTotal) { console.log('Started loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.'); }; manager.onLoad = function() { console.log('Loading complete!'); }; manager.onProgress = function(url, itemsLoaded, itemsTotal) { console.log('Loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.'); }; manager.onError = function(url) { console.log('There was an error loading ' + url); }; const loader = new v3d.OBJLoader(manager); loader.load('file.obj', function(object) { // });`

除了观察进度流程之外，还可以使用LoadingManager在加载期间覆写资源URL。当某资源来自拖拽事件、 WebSockets、WebRTC或其他API时，此方法可以有所帮助。下面显示了如何使用Blob URL加载内存模型的示例。

`// 将文件拖入网页时创建的Blob或File对象。 const blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3}; const manager = new v3d.LoadingManager(); // 使用URL回调初始化加载管理器。 const objectURLs = []; manager.setURLModifier((url) => { url = URL.createObjectURL(blobs[url]); objectURLs.push(url); return url; }); // 像通常一样加载，然后撤消blob URL const loader = new v3d.GLTFLoader(manager); loader.load('fish.gltf', (gltf) => { app.scene.add(gltf.scene); objectURLs.forEach((url) => URL.revokeObjectURL(url)); });`

## 构造方法

### LoadingManager(onLoad : Function, onProgress : Function, onError : Function)

onLoad — (可选) 所有加载器加载完成后，将调用此函数。
onProgress — (可选) 当每个项目完成后，将调用此函数。
onError — (可选) 当一个加载器遇到错误时，将调用此函数。
创建一个新的 LoadingManager.

## 属性

### # .onStart : Function

此函数在加载开始时被调用。 有如下参数：
url — 被加载的项的url。
itemsLoaded — 目前已加载项的个数。
itemsTotal — 总共所需要加载项的个数。
该函数默认为undefined。

### # .onLoad : Function

所有的项目加载完成后将调用此函数。默认情况下，该函数是未定义的，除非在构造函数中传入。

### # .onProgress : Function

此方法加载每一个项，加载完成时进行调用。 有如下参数：
url — 被加载的项的url。
itemsLoaded — 目前已加载项的个数。
itemsTotal — 总共所需要加载项的个数。
默认情况下，该函数为undefined，除非在构造函数中传入。

### # .onError : Function

此方法将在任意项加载错误时，进行调用。 有如下参数：
url — 加载发生错误的项目的url
默认情况下，该函数为undefined，除非在构造函数中传入。

## 方法

### # .addHandler(regex : Object, loader : Loader) → LoadingManager

regex — A regular expression.
loader — The loader.

Registers a loader with the given regular expression. Can be used to define what loader should be used in order to load specific files. A typical use case is to overwrite the default loader for textures.

`// add handler for TGA textures manager.addHandler(/\.tga$/i, new TGALoader());`

### # .getHandler(file : String) → null

file — The file path.

Can be used to retrieve the registered loader for the given file path.

### # .removeHandler(regex : Object) → LoadingManager

regex — A regular expression.

Removes the loader for the given regular expression.

### # .resolveURL(url : String) → String

url — 所要加载的url
给定URL，使用URL修饰符回调（如果有）并返回已解析的URL。如果未设置URL修饰符，则返回原始URL。

### # .setURLModifier(callback : Function) → null

callback — 设置URL修饰符成功时回调。使用url参数进行回调，并且必须返回 resolvedURL 。
如果设置了回调，则在发送请求之前将向每个资源URL传递回调。回调可以返回最初的URL，也可以返回新URL以覆盖加载行为。 此行为可用于从.ZIP、拖拽API和数据URI中加载资源文件。

Note: The following methods are designed to be called internally by loaders. You shouldn't call them directly.

### # .itemStart(url : String) → null

url — 所要加载的url
任何使用管理器的加载器都会调用此方法， 当加载器需要开始加载URL时。

### # .itemEnd(url : String) → null

url — 所要加载的url
任何使用管理器的加载器都会调用此方法， 当加载器需要加载URL结束时。

### # .itemError(url : String) → null

url — 所要加载的url
任何使用管理器的加载器都会调用此方法， 当加载器出现加载错误时。

## 源

src/loaders/LoadingManager.js