卷积器节点:卷积器节点() 构造函数

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本上运行。自 2021 年 4 月.

ConvolverNode()Web 音频 API 的构造函数,用于创建新的 ConvolverNode 对象实例。

语法

js
new ConvolverNode(context, options)

参数

上下文

AudioContext 的引用。

options 可选

选项如下

缓冲区

单声道、立体声或 4 声道 AudioBuffer,其中包含 ConvolverNode 用于创建混响效果的(可能为多通道的)冲激响应。

disableNormalization

一个布尔值,用于控制是否对来自缓冲区的冲激响应进行等功率归一化缩放,或者不进行缩放。默认值为“false”。

channelCount

表示一个整数,用于确定对节点的任何输入进行 上混和下混 连接时使用的通道数量。(有关更多信息,请参阅 AudioNode.channelCount。)其用法和确切定义取决于 channelCountMode 的值。

channelCountMode

表示一个枚举值,描述了节点输入和输出之间必须匹配通道的方式。(有关更多信息,包括默认值,请参阅 AudioNode.channelCountMode。)

channelInterpretation

表示一个枚举值,描述了通道的含义。此解释将定义音频 上混和下混 的方式。可能的值为 "speakers""discrete"。(有关更多信息,包括默认值,请参阅 AudioNode.channelCountMode。)

返回值

新的 ConvolverNode 对象实例。

异常

NotSupportedError DOMException

如果引用的 AudioBuffer 没有正确数量的通道,或者其采样率与关联的 AudioContext 不同,则会抛出此异常。

规范

规范
Web 音频 API
# dom-convolvernode-constructor-convolvernode

浏览器兼容性

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