BiquadFilterNode
BiquadFilterNode
接口表示一个简单的低阶滤波器,并使用 BaseAudioContext/createBiquadFilter
方法创建。它是一个 AudioNode
,可以表示不同类型的滤波器、音调控制设备和图形均衡器。BiquadFilterNode
始终只有一个输入和一个输出。
输入数量 | 1 |
---|---|
输出数量 | 1 |
通道数模式 | "最大" |
通道数 | 2 (在默认计数模式下未使用) |
通道解释 | "扬声器" |
构造函数
BiquadFilterNode()
-
创建一个新的
BiquadFilterNode
对象实例。
实例属性
继承其父级 AudioNode
的属性.
注意:虽然返回的 AudioParam
对象是只读的,但它们表示的值不是。
BiquadFilterNode.frequency
只读-
一个 a 速率
AudioParam
,一个双精度数,表示当前滤波算法中以赫兹 (Hz) 为单位测量的频率。 BiquadFilterNode.detune
只读-
一个 a 速率
AudioParam
,表示以 音分 为单位的频率失谐。 BiquadFilterNode.Q
只读-
一个 a 速率
AudioParam
,一个双精度数,表示 Q 因子 或品质因数。 BiquadFilterNode.gain
只读-
一个 a 速率
AudioParam
,一个双精度数,表示当前滤波算法中使用的 增益。 BiquadFilterNode.type
-
一个字符串值,定义节点正在实现的滤波算法类型。
不同参数的含义取决于滤波器的类型(失谐的含义始终相同,因此未在下面列出) 类型
描述 频率
Q 值
增益
低通
标准二阶谐振低通滤波器,滚降速率为 12dB/倍频程。截止频率以下的频率通过;截止频率以上的频率被衰减。 截止频率。 指示截止频率周围的频率峰值程度。值越大,峰值越大。 未使用 高通
标准二阶谐振高通滤波器,滚降速率为 12dB/倍频程。截止频率以下的频率被衰减;截止频率以上的频率通过。 截止频率。 指示截止频率周围的频率峰值程度。值越大,峰值越大。 未使用 带通
标准二阶带通滤波器。给定频率范围外的频率被衰减;范围内的频率通过。 频率范围的中心。 控制频带宽度。 Q
值越大,频带越小。未使用 低架
标准二阶低架滤波器。低于频率的频率获得提升或衰减;高于频率的频率保持不变。 获得提升或衰减的频率的上限。 未使用 要应用的提升,以 dB 为单位;如果为负值,则为衰减。 高架
标准二阶高架滤波器。高于频率的频率获得提升或衰减;低于频率的频率保持不变。 获得提升或衰减的频率的下限。 未使用 要应用的提升,以 dB 为单位;如果为负值,则为衰减。 峰值
范围内的频率获得提升或衰减;范围外的频率保持不变。 获得提升或衰减的频率范围的中间。 控制频带宽度。 Q
值越大,频带越小。要应用的提升,以 dB 为单位;如果为负值,则为衰减。 陷波
标准 陷波 滤波器,也称为带阻或带抑制滤波器。它与带通滤波器相反:给定频率范围外的频率通过;范围内的频率被衰减。 频率范围的中心。 控制频带宽度。 Q
值越大,频带越小。未使用 全通
标准二阶 全通 滤波器。它允许所有频率通过,但会改变各种频率之间的相位关系。 具有最大 群延迟 的频率,即相位转换中心发生的频率。 控制中频处转换的锐度。此参数越大,转换越锐利且幅度越大。 未使用
实例方法
继承其父级 AudioNode
的方法.
BiquadFilterNode.getFrequencyResponse()
-
根据当前滤波器参数设置,此方法计算在提供的频率数组中指定的频率的频率响应。
示例
请参阅 AudioContext.createBiquadFilter
,了解显示如何使用 AudioContext
创建双二次滤波器节点的示例代码。
规范
规范 |
---|
Web 音频 API # BiquadFilterNode |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。