卷积器节点：normalize 属性

基线 广泛可用

此功能非常成熟，可在许多设备和浏览器版本中使用。它已在浏览器中可用，从 2021 年 4 月.

normalize 属性是 ConvolverNode 接口的布尔值属性，控制当 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 音频 API
# dom-convolvernode-normalize

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参见