convolvernode需加载真实脉冲响应（ir）音频缓冲区才生效，必须按“用户交互→启动audiocontext→fetch+decodeaudiodata→赋值buffer→连接节点”时序执行，否则静音或失效。
convolver节点必须加载真实脉冲响应（IR）音频文件才能生效
直接调用 createConvolver() 不会自动产生混响，它只是个空壳处理器——必须手动加载并赋值一个脉冲响应音频缓冲区（convolver.buffer）。常见错误是忘记赋值或赋了 null，此时音频静音且无报错。IR 文件通常为单声道、16/24-bit PCM WAV，采样率需与 AudioContext 一致（推荐 48kHz 或 44.1kHz），否则可能失真或播放异常。
实操建议：
- 用
fetch()+arrayBuffer+decodeAudioData()加载 IR 文件，避免使用XMLHttpRequest的同步模式（已废弃） - IR 长度影响性能：500ms 以内的 IR 较安全；超过 2s 可能导致高 CPU 占用或 iOS Safari 崩溃
- 加载失败时检查
convolver.buffer是否为null，可在控制台打印convolver.buffer?.length确认
IR 文件必须解码为 AudioBuffer 后才能赋给 convolver.buffer
convolver.buffer 接收的是 AudioBuffer 对象，不是 Blob、URL 或 HTMLAudioElement。试图直接赋值 new Audio() 的 src 或 currentSrc 会静默失败。
典型正确流程：
const irUrl = '/assets/room-impulse.wav';
fetch(irUrl)
.then(res => res.arrayBuffer())
.then(arrayBuffer => audioContext.decodeAudioData(arrayBuffer))
.then(audioBuffer => {
convolver.buffer = audioBuffer; // ✅ 正确赋值
})
.catch(err => console.error('IR load failed:', err));
注意点：
-
decodeAudioData()是异步的，不能在fetch().then(() => convolver.buffer = ...)中跳过解码直接赋原始 ArrayBuffer - 若 IR 是立体声，
convolver默认只使用左声道（第一通道）；如需双耳混响，需提前转为单声道或用ChannelMergerNode处理 - 某些 IR 文件含元数据或非标准 chunk（如某些 Audacity 导出的 WAV），可能触发
decodeAudioData()报错DOMException: Unable to decode audio data
convolver 节点需接入音频图（Audio Graph）且 buffer 非空才起作用
即使 convolver.buffer 已设置，如果节点没连接到输出（例如没接 convolver.connect(audioContext.destination) 或中间断连），依然听不到效果。更隐蔽的问题是：buffer 在连接后才被赋值，而 Web Audio 规范要求 buffer 必须在节点连接前就存在，否则部分浏览器（尤其是 Safari）会忽略后续赋值。
稳妥做法：
- 先创建
convolver，再加载并赋值buffer，最后连接到图中 - 避免“先 connect 再 set buffer”——这在 Chrome 可能偶然工作，但在 Safari 17+ 和 Firefox 中必然失效
- 若需动态切换 IR，应先断开连接（
convolver.disconnect()），更新buffer，再重连；否则旧 buffer 仍被使用 - 混响强度由 IR 幅值决定，不依赖增益节点；但若 IR 过大导致削波，可在 convolver 前加
gainNode.gain.value = 0.3做预衰减
移动端 Safari 对 convolver 有额外限制和兼容性坑
iOS/iPadOS Safari（尤其 16.4+）对 ConvolverNode 施加了严格限制：未与用户手势（如 click、touchstart）绑定的 AudioContext 无法启动，且 IR 长度超过 ~1.2 秒时可能被截断或静音。
绕过要点：
- 必须在用户交互回调内调用
audioContext.resume()，不能在页面加载时自动启动 - IR 文件尽量压缩长度：用专业工具（如 Voxengo DeaRVerb）生成 800ms 以内高质量 IR，而非直接用长房间录音
- 测试时禁用「静音标签页自动暂停」：Safari 设置 → 高级 → 关闭「网页播放器自动暂停」
- 不要依赖
convolver.buffer.length判断是否就绪——iOS 上该值可能始终为 0，应监听onload或用 Promise 链保证顺序
真实项目里最常被忽略的，是把 IR 加载逻辑放在 AudioContext 创建之前，或假设「只要 buffer 设了就能立刻生效」——其实整个链路必须严格按「用户交互 → 启动 context → 加载 IR → 解码 → 赋值 → 连接」的时序执行，缺一不可。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
