ConvolverNode: buffer 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

ConvolverNode 接口的 buffer 属性表示一个单声道、立体声或 4 声道的 AudioBuffer,其中包含用于 ConvolverNode 创建混响效果的(可能多通道的)脉冲响应。

这通常是对您想要建模的空间中尽可能接近脉冲的简单录音。例如,如果您想模拟浴室的混响,您可以在门附近设置一个麦克风来录制一个气球爆炸声或水槽发出的合成脉冲的声音。然后可以使用该音频录音作为 buffer。

此音频 buffer 的采样率必须与 AudioContext 的采样率相同,否则将抛出异常。设置此属性时,buffer 和该属性的状态将用于使用给定的归一化配置 ConvolverNode 的脉冲响应。此属性的初始值为 null

一个 AudioBuffer

示例

分配音频 buffer

以下示例创建了一个卷积节点并为其分配了一个 AudioBuffer

有关更完整、更实际的应用示例/信息,请查看我们的 Voice-change-O-matic 演示(有关下面摘录的代码,请参阅 app.js)。

js
const audioCtx = new AudioContext();
// …

const convolver = audioCtx.createConvolver();
// …

// Grab audio track via fetch() for convolver node
try {
  const response = await fetch(
    "https://mdn.github.io/voice-change-o-matic/audio/concert-crowd.ogg",
  );
  const arrayBuffer = await response.arrayBuffer();
  const decodedAudio = await audioCtx.decodeAudioData(arrayBuffer);
  convolver.buffer = decodedAudio;
} catch (error) {
  console.error(
    `Unable to fetch the audio file: ${name} Error: ${err.message}`,
  );
}

规范

规范
Web Audio API
# dom-convolvernode-buffer

浏览器兼容性

另见