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

瀏覽器相容性

另見