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.load()

Loader.load(url: string, onLoad: Function, onProgress?: Function, onError?: Function): void

该函数用于加载三维模型、音频、视频等资源文件。

参数说明

url:需要加载的资源文件的 URL。

onLoad:加载成功后的回调函数,会将加载好的资源作为参数传入。

onProgress:加载过程中的回调函数,可用于显示加载进度条,默认值为 undefined

onError:加载失败后的回调函数,默认值为 undefined

范例

以下为加载一个 .glb 格式的三维模型的范例:

import * as THREE from 'three';

const loader = new THREE.GLTFLoader();

loader.load(
    'models/model.glb',
    (gltf) => {
        scene.add(gltf.scene);
    },
    (xhr) => {
        console.log((xhr.loaded / xhr.total * 100) + '% 已加载');
    },
    (error) => {
        console.log('模型加载失败:' + error);
    }
);

注意事项

  1. 资源文件的 URL 需要正确,否则会导致加载失败。
  2. 如果资源文件过大,建议在 onProgress 回调函数中加入进度条等提示,以免用户误解场景卡住了。