Web Audio API下多WAV音频同步播放的最佳实践咨询
多音频同步播放最佳实践(Web Audio API)
原代码的问题
- 没等音频加载解码完就调用
start(0),此时缓冲区是空的,根本播不出来 - 两个音频各自独立加载、独立触发播放,哪怕都加载完了,JS主线程的执行时差也会让两个播放起始点错位
- 有低级逻辑bug:第二个音频的
onload回调里,错误读了第一个请求的响应,第二个音频永远拿不到正确数据
实现逻辑
Web Audio有独立于JS主线程的高精度音频时钟,同步的核心规则是:
- 所有要同步播放的音频,必须先全部完成加载、解码
- 统一给所有播放源指定同一个音频时钟时间点触发播放,不要单独触发单个音频
修正后的代码
const audioContext = new AudioContext(); // 封装单个音频的加载+解码流程,返回Promise方便统一追踪进度 function loadAudio(url) { return new Promise((resolve, reject) => { const req = new XMLHttpRequest(); req.open('GET', url, true); req.responseType = 'arraybuffer'; req.onload = () => { audioContext.decodeAudioData(req.response) .then(resolve) .catch(reject); }; req.onerror = reject; req.send(); }); } // 并行加载两个待同步的音频 Promise.all([ loadAudio('http://localhost:8000/mywave1.wav'), loadAudio('http://localhost:8000/mywave2.wav') ]).then(([buf1, buf2]) => { // 取当前音频时钟的时间,加0.1s的缓冲,给调度器留处理空间 const syncStartTime = audioContext.currentTime + 0.1; // 批量创建播放源,统一用同一个时间点启动 [buf1, buf2].forEach(buffer => { const source = audioContext.createBufferSource(); source.buffer = buffer; source.connect(audioContext.destination); source.start(syncStartTime); }); }).catch(err => { console.error('音频加载失败', err); });
避坑要点
- 别写死
start(0),一定要用当前audioContext.currentTime加一个微小的缓冲时间,避免第一个节点启动后,后续节点的调度延迟导致错位 - 每个
BufferSource是一次性的,每次播放都要重新创建,不能复用之前的实例 - 绝对不要在单个音频的加载回调里单独触发该音频的播放,必须等所有同步音频都就绪后再批量启动
- 注意浏览器自动播放限制:现代浏览器默认会将新创建的
AudioContext设为suspended状态,需要在用户交互(如点击按钮)的回调里调用audioContext.resume()后再启动播放,否则音频不会发声。
内容的提问来源于stack exchange,提问作者whitebear
相关产品推荐
相关产品推荐

