BaseAudioContext: createIIRFilter() 方法

Baseline 已广泛支持

此特性已得到良好支持,可在多种设备和浏览器版本上使用。自 2021 年 4 月起,所有浏览器均已支持此特性。

BaseAudioContext 接口的 createIIRFilter() 方法创建一个 IIRFilterNode,它代表一个通用的无限脉冲响应 (IIR) 滤波器,可以配置为作为各种类型的滤波器使用。

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

语法

js
createIIRFilter(feedforward, feedback)

参数

前馈

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

反馈

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

返回值

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

异常

InvalidStateError DOMException

如果所有 feedforward 系数都为 0,或者第一个 feedback 系数为 0,则抛出此错误。

NotSupportedError DOMException

如果输入数组中的一个或两个数组的成员数超过 20,则抛出此错误。

规范

规范
Web Audio API
# dom-baseaudiocontext-createiirfilter

浏览器兼容性

另见