卷积器节点:卷积器节点() 构造函数
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 的浏览器中加载。