BiquadFilterNode

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

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

EventTarget AudioNode BiquadFilterNode
输入数量 1
输出数量 1
通道计数模式 "max"
声道数 2 (在默认计数模式下未使用)
通道解释 “speakers”

构造函数

BiquadFilterNode()

创建一个新的 BiquadFilterNode 对象实例。

实例属性

继承自其父级 AudioNode 的属性.

注意: 尽管返回的 AudioParam 对象是只读的,但它们表示的值不是只读的。

BiquadFilterNode.frequency 只读

一个 a-rateAudioParam,一个表示当前滤波算法中频率的 double 类型值,单位为赫兹 (Hz)。

BiquadFilterNode.detune 只读

一个 a-rateAudioParam,表示频率的 音分 偏移。

BiquadFilterNode.Q 只读

一个 a-rateAudioParam,一个表示 Q 值(或称品质因数)的 double 类型值。

BiquadFilterNode.gain 只读

一个 a-rateAudioParam,一个表示当前滤波算法中使用的 增益double 类型值。

BiquadFilterNode.type

一个字符串值,定义了节点实现的滤波算法的类型。

不同参数的含义取决于滤波器的类型(detune 的含义始终相同,因此不在此列出)
type 描述 frequency Q gain
lowpass 标准的二阶共振低通滤波器,滚降率为 12dB/倍频程。低于截止频率的频率会通过;高于截止频率的频率会被衰减。 截止频率。 指示在截止频率周围的频率峰值程度。值越大,峰值越大。 未使用
highpass 标准的二阶共振高通滤波器,滚降率为 12dB/倍频程。低于截止频率的频率会被衰减;高于截止频率的频率会通过。 截止频率。 指示在截止频率周围的频率峰值程度。值越大,峰值越大。 未使用
bandpass 标准的二阶带通滤波器。给定频率范围之外的频率会被衰减;范围之内的频率会通过。 频率范围的中心。 控制频率带的宽度。Q 值越大,频率带越窄。 未使用
lowshelf 标准的二阶低架滤波器。低于指定频率的频率会获得提升(增益)或衰减;高于指定频率的频率保持不变。 获得提升或衰减的频率的上限。 未使用 要应用的增益(以 dB 为单位);如果为负数,则表示衰减。
highshelf 标准的二阶高架滤波器。高于指定频率的频率会获得提升(增益)或衰减;低于指定频率的频率保持不变。 获得提升或衰减的频率的下限。 未使用 要应用的增益(以 dB 为单位);如果为负数,则表示衰减。
peaking 范围内的频率会获得提升或衰减;范围外的频率保持不变。 获得提升或衰减的频率范围的中心。 控制频率带的宽度。Q 值越大,频率带越窄。 要应用的增益(以 dB 为单位);如果为负数,则表示衰减。
notch 标准的 陷波 滤波器,也称为带阻带衰减滤波器。它与带通滤波器相反:给定频率范围之外的频率会通过;范围之内的频率会被衰减。 频率范围的中心。 控制频率带的宽度。Q 值越大,频率带越窄。 未使用
allpass 标准的二阶 全通 滤波器。它让所有频率通过,但会改变各种频率之间的相位关系。 具有最大 群延迟 的频率,即相位过渡中心发生的频率。 控制中频过渡的锐度。该参数越大,过渡将越锐利,幅度也越大。 未使用

实例方法

继承自其父级 AudioNode 的方法.

BiquadFilterNode.getFrequencyResponse()

根据当前的滤波器参数设置,此方法会计算给定频率数组中指定频率的频率响应。

示例

有关如何使用 AudioContext 创建 Biquad 滤波器节点的示例代码,请参阅 AudioContext.createBiquadFilter

规范

规范
Web Audio API
# BiquadFilterNode

浏览器兼容性

另见