BiquadFilterNode

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中可用: 2021 年 4 月.

BiquadFilterNode 接口表示一个简单的低阶滤波器,并使用 BaseAudioContext/createBiquadFilter 方法创建。它是一个 AudioNode,可以表示不同类型的滤波器、音调控制设备和图形均衡器。BiquadFilterNode 始终只有一个输入和一个输出。

EventTarget 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 的浏览器中加载。

另请参阅