BaseAudioContext: createIIRFilter() 方法

基线 广泛可用

此功能已得到充分建立,并且可在许多设备和浏览器版本上运行。它已在各种浏览器中可用,自 2021 年 4 月.

createIIRFilter() 方法是 BaseAudioContext 接口的一个方法,它创建一个 IIRFilterNode,该节点表示一个通用的 无限冲激响应 (IIR) 滤波器,可以将其配置为用作各种类型的滤波器。

注意:IIRFilterNode() 构造函数是创建 IIRFilterNode 的推荐方式;请参阅 创建 AudioNode

语法

js
createIIRFilter(feedforward, feedback)

参数

feedforward

一个浮点值数组,用于指定 IIR 滤波器传递函数的前馈(分子)系数。此数组的最大长度为 20,并且至少一个值必须非零。

feedback

一个浮点值数组,用于指定 IIR 滤波器传递函数的反馈(分母)系数。此数组最多可以有 20 个成员,其中第一个成员不能为零。

返回值

一个 IIRFilterNode,它使用指定的反馈和前馈系数数组实现滤波器。

异常

InvalidStateError DOMException

如果所有 feedforward 系数均为 0,或者如果第一个 feedback 系数为 0,则抛出此异常。

NotSupportedError DOMException

如果一个或两个输入数组超过 20 个成员,则抛出此异常。

规范

规范
Web 音频 API
# dom-baseaudiocontext-createiirfilter

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅