ConvolverNode: normalize 属性

Baseline 已广泛支持

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

ConvolverNode 接口的 normalize 属性是一个布尔值,用于控制当设置 buffer 属性时,是否对缓冲区中的脉冲响应进行等功率归一化缩放。

其默认值为 true,以便在使用不同的脉冲响应加载时,从卷积器获得更均匀的输出电平。如果将 normalize 设置为 false,则渲染卷积时将不对脉冲响应进行预处理/缩放。对该值的更改直到下一次设置 buffer 属性时才会生效。

布尔值。

示例

关闭归一化

以下示例创建了一个卷积器节点并为其分配了一个 AudioBuffer。在分配音频缓冲区之前,它将 normalize 设置为 false

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.normalize = false; // must be set before the buffer, to take effect
  convolver.buffer = decodedAudio;
} catch (error) {
  console.error(
    `Unable to fetch the audio file: ${name} Error: ${err.message}`,
  );
}

规范

规范
Web Audio API
# dom-convolvernode-normalize

浏览器兼容性

另见