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

Loader →

# GLTFLoader

glTF 2.0 资源加载器。
glTF (GL Transmission Format) is an open format specification for efficient delivery and loading of 3D content. Assets may be provided either in JSON (.gltf) or binary (.glb) format. External files store textures (.jpg, .png, ...) and additional binary data (.bin). A glTF asset may deliver one or more scenes, including meshes, materials, textures, skins, skeletons, morph targets, animations, lights, and/or cameras.
glTF (GL 传输格式) 是一种 开放格式规范，用于高效交付和加载 3D 内容。资产可以以 JSON (.gltf) 或二进制 (.glb) 格式提供。外部文件存储纹理（.jpg、.png、...）和额外的二进制数据 (.bin)。 glTF 资产可以提供一个或多个场景，包括网格、材质、纹理、皮肤、骨架、变形目标、动画、灯光和/或相机。

## 扩展

GLTFLoader 支持以下 glTF 扩展：

- S8S_v3d_animation_data
- S8S_v3d_data
- S8S_v3d_camera_data
- S8S_v3d_material_data
- S8S_v3d_mesh_data
- S8S_v3d_node_data
- S8S_v3d_scene_data
- S8S_v3d_texture_data

## 示例

`// Instantiate a loader var loader = new v3d.GLTFLoader(); // Load a glTF resource loader.load('models/gltf/duck/duck.gltf', function(gltf) { app.scene.add(gltf.scene); gltf.animations; // Array<v3d.AnimationClip> gltf.scene; // v3d.Scene gltf.scenes; // Array<v3d.Scene> gltf.cameras; // Array<v3d.Camera> });`

## 构造函数

### GLTFLoader(manager)

manager — 加载器使用的loadingManager。 默认为 [page:LoadingManager v3d.DefaultLoadingManager]。
创建一个新的 GLTFLoader。
新建 GLTFLoader。

## 属性

## 方法

### # .load(url, onLoad, onProgress, onError) → null

url — 必须
onLoad — 加载完成时将被调用。参数是从 parse 返回的加载的 JSON 响应。
onProgress — 将在加载进行时调用。 参数是包含 .total 和 .loaded 字节的 XMLHttpRequest 实例。
onError — 加载错误时调用。
从 url 开始加载并使用解析的响应内容调用回调函数。

### # .setPath(path) → null

path — 加载其他资源的基本路径，例如纹理和 .bin 数据。
设置附加资源的基本路径。

### # .setCrossOrigin(value) → null

value — 实现 CORS 的 crossOrigin 字符串，用于从允许 CORS 的不同域加载 url。

### # .parse(json, callBack, path) → null

json — 要解析的 JSON 对象。
callBack — 解析完成时将被调用。
path — 从中查找后续 glTF 资源（例如纹理和 .bin 数据文件）的基本路径。 files.
Parse a glTF-based JSON structure and fire callback when complete. The argument to callback will be an object that contains loaded parts: .scene, .[page:Array scenes], .cameras, and .animations. 解析基于 glTF 的 JSON 结构并在完成时触发callback。 callback 的参数将是一个包含加载部分的object：.scene, .[page:Array scenes], .cameras, 和 .animations。

## 源代码

关于如何获取此模块的源代码，请查看 本页。