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

Audio.play()

Audio.play 方法播放一个 Audio 对象。

语法

audio.play();

参数

无参数。

返回值

无返回值。

描述

Audio.play 方法播放一个已经加载的音频文件。在被调用之前,必须确保音频文件已经成功加载且可用。

如果音频文件还未被加载,或者加载失败,那么调用 Audio.play 方法将会没有任何效果。

如果想要实现循环播放,可以在 Audio 对象上设置 loop 属性为 true

示例

// 创建一个音频文件对象
var audio = new THREE.Audio(listener);

// 加载一个音频文件
var loader = new THREE.AudioLoader();
loader.load('music.mp3', function(buffer) {
    audio.setBuffer(buffer);
    audio.play();
});

注意事项

必须在用户与页面进行了交互之后才能播放音频文件。这是为了保护用户免受不必要的干扰和骚扰。

在移动设备上,对于许多浏览器而言,需要先触发用户交互才能播放音频文件。在移动设备上,要使用 THREE.AudioContext.resume() 方法触发交互事件。

参考文献