BufferGeometry
Object3D
Raycaster
Camera
CubeCamera
PerspectiveCamera
OrthographicCamera
StereoCamera
Clock
Curve
CurvePath
Path
Shape
ShapePath
ArrowHelper
AxesHelper
BoxHelper
Box3Helper
CameraHelper
DirectionalLightHelper
GridHelper
PolarGridHelper
HemisphereLightHelper
PlaneHelper
PointLightHelper
SkeletonHelper
SpotLightHelper
Light
PointLight
RectAreaLight
SpotLight
DirectionalLight
HemisphereLight
LightShadow
PointLightShadow
AnimationLoader
AudioLoader
BufferGeometryLoader
CompressedTextureLoader
CubeTextureLoader
DataTextureLoader
FileLoader
ImageBitmapLoader
ImageLoader
Loader
LoaderUtils
MaterialLoader
ObjectLoader
TextureLoader
LoadingManager
Material
Box2
Box3
Color
Cylindrical
Euler
Frustum
Interpolant
Line3
MathUtils
Matrix3
Matrix4
Plane
Quaternion
AnimationAction
AnimationClip
AnimationMixer
AnimationObjectGroup
AnimationUtils
keyframeTrack
PropertyBinding
PropertyMixer
BooleanKeyframeTrack
QuaternionKeyframeTrack
StringKeyframeTrack
Audio
AudioAnalyser
AudioContext
AudioListener
PositionalAudio

Loader.loadAsync()

介绍

Loader 是一个用于加载和解析三维模型和纹理等资源的类,它是 Three.js 引擎的重要组成部分。Loader.loadAsync() 方法是 Loader 类的一个异步加载方法,用于加载文件并将其解析为 Three.js 可以使用的对象。该方法返回一个 Promise 对象,可以使用 async/awaitthen/catch 方法进行调用。

语法

loader.loadAsync(url[, onProgress][, onError])
  • url:要加载的文件的 URL 地址。
  • onProgress:可选参数,一个在加载过程中被调用的函数,会传递当前加载进度(0-1)。
  • onError:可选参数,一个在加载失败时被调用的函数,会传递一个 Error 对象,包含错误信息。

返回值

返回一个 Promise 对象,该对象可以用 async/awaitthen/catch 方法进行调用。当文件成功加载并解析为 Three.js 对象时,将 resolve 返回一个对象;否则,将 reject 返回一个错误对象。

使用示例

import * as THREE from 'three';

const loader = new THREE.GLTFLoader();

async function loadModel() {
  try {
    const gltf = await loader.loadAsync('/path/to/model.glb');
    console.log('Model loaded:', gltf);
  } catch (error) {
    console.error('Failed to load model:', error);
  }
}

loadModel();

注意事项

  • 在调用 Loader.loadAsync() 方法时,请确保文件路径正确。如果文件路径错误或文件不存在,将会触发 onError 回调函数。
  • 如果你需要发起多个加载请求,请确保每个请求都是独立的,不会干扰或依赖其他请求。否则,可能会导致文件加载失败或加载顺序混乱的问题。
  • 如果你的场景比较复杂,需要加载多个模型和纹理等资源,请考虑使用场景图管理器(Scene Graph Manager)将它们组织在一起,以避免加载过程中的混乱和冗余代码。