ConvolverNode:ConvolverNode() 构造函数

Baseline 已广泛支持

此特性已得到良好支持,可在多种设备和浏览器版本上使用。自 2021 年 4 月起,所有浏览器均已支持此特性。

Web Audio API 的 ConvolverNode() 构造函数创建一个新的 ConvolverNode 对象实例。

语法

js
new ConvolverNode(context, options)

参数

context

AudioContext 的引用。

options 可选

选项如下:

buffer

一个单声道、立体声或四声道 AudioBuffer,其中包含 ConvolverNode 用于创建混响效果的(可能是多声道的)脉冲响应。

disableNormalization

一个布尔值,用于控制脉冲响应是否会通过等效功率进行归一化。默认为 false

channelCount

表示一个整数,用于确定在 上混和下混 连接到节点时使用的通道数。(有关更多信息,请参阅 AudioNode.channelCount。)其用法和精确定义取决于 channelCountMode 的值。

channelCountMode

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

channelInterpretation

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

返回值

一个新的 ConvolverNode 对象实例。

异常

NotSupportedError DOMException

如果引用的 AudioBuffer 没有正确的通道数,或者其采样率与关联的 AudioContext 不同,则会引发此错误。

规范

规范
Web Audio API
# dom-convolvernode-convolvernode

浏览器兼容性