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

瀏覽器相容性

另見