SuperAPI AI 工具集

threejs-impl-audio

数据与分析

查看项目

更新于 10-15 22:18

技能介绍

用途:为 Three.js 场景加入声音,包括背景音乐、3D 空间音频与音频可视化。资料明确了三类声音对象:AudioListener 为接收者且始终挂载到相机;Audio 用于非定位声音(背景音乐、UI 音效);PositionalAudio 用于绑定到场景物体的 3D 空间声音。

主要能力:AudioListener 提供主音量与全局滤波器;Audio 支持循环、音量、播放速率、变调,可用 HTML5 媒体元素或麦克风流作为音源;PositionalAudio 支持 refDistance、maxDistance、rolloffFactor 与 inverse/linear/exponential 距离模型,并可用 setDirectionalCone 设置方向锥;AudioLoader 异步加载音频并带进度与错误回调;AudioAnalyser 用 getFrequencyData 与 getAverageFrequency 做实时频谱可视化。

必要用法与限制:现代浏览器会挂起 AudioContext,必须在点击等用户手势处理器内调用 listener.context.resume() 后才能 play(),不能依赖 autoplay;每个场景只能有一个 AudioListener,且须加到相机上;AudioLoader.load() 必须处理 onError 回调,否则加载失败会静默;OGG 在 Safari 不受支持,需提供 MP3 回退;fftSize 必须是 2 的幂。

适用场景:游戏或交互页面的背景音乐、环境声与音效,绑定到网格的空间声音,以及随音乐驱动的视觉动画。其他参数、价格与平台信息资料未提供。