BiquadFilterNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das BiquadFilterNode-Interface repräsentiert einen einfachen Filter niedriger Ordnung und wird mit der Methode BaseAudioContext/createBiquadFilter erstellt. Es ist ein AudioNode, das verschiedene Arten von Filtern, Tonkontrollgeräten und grafischen Equalizern darstellen kann. Ein BiquadFilterNode hat immer genau einen Eingang und einen Ausgang.

Anzahl der Eingänge	`1`
Anzahl der Ausgänge	`1`
Kanalanzahlmodus	`"max"`
Kanalanzahl	`2` (nicht verwendet im Standardmodus)
Kanalauslegung	`"speakers"`

Konstruktor

BiquadFilterNode(): Erstellt eine neue Instanz eines BiquadFilterNode-Objekts.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, AudioNode.

Hinweis: Obwohl die zurückgegebenen AudioParam-Objekte schreibgeschützt sind, sind die Werte, die sie repräsentieren, es nicht.

BiquadFilterNode.frequency Schreibgeschützt

Ein a-rate AudioParam, ein Double, das eine Frequenz im aktuellen Filteralgorithmus in Hertz (Hz) darstellt.

BiquadFilterNode.detune Schreibgeschützt

Ein a-rate AudioParam, das die Verstimmung der Frequenz in Cent repräsentiert.

BiquadFilterNode.Q Schreibgeschützt

Ein a-rate AudioParam, ein Double, das einen Q-Faktor oder Qualitätsfaktor darstellt.

BiquadFilterNode.gain Schreibgeschützt

Ein a-rate AudioParam, ein Double, das den Gain im aktuellen Filteralgorithmus darstellt.

BiquadFilterNode.type

Ein String-Wert, der die Art des Filteralgorithmus definiert, den der Knoten implementiert.

Die Bedeutung der verschiedenen Parameter, abhängig vom Filtertyp (Detune hat unabhängig davon die gleiche Bedeutung, daher wird es unten nicht aufgeführt)
`type`	Beschreibung	`frequency`	`Q`	`gain`
`lowpass`	Standardmäßiger zweiter Ordnung resonanter Tiefpassfilter mit 12dB/Oktave Roll-off. Frequenzen unterhalb des Grenzfrequenz passieren; Frequenzen darüber werden abgeschwächt.	Die Grenzfrequenz.	Gibt an, wie stark die Frequenz um die Grenzfrequenz herum betont ist. Je höher der Wert, desto stärker der Peak.	Nicht verwendet
`highpass`	Standardmäßiger zweiter Ordnung resonanter Hochpassfilter mit 12dB/Oktave Roll-off. Frequenzen unterhalb der Grenzfrequenz werden abgeschwächt; Frequenzen darüber passieren.	Die Grenzfrequenz.	Gibt an, wie stark die Frequenz um die Grenzfrequenz herum betont ist. Je höher der Wert, desto stärker der Peak.	Nicht verwendet
`bandpass`	Standardmäßiger zweiter Ordnung Bandpassfilter. Frequenzen außerhalb des gegebenen Frequenzbereichs werden abgeschwächt; die Frequenzen innerhalb passieren.	Das Zentrum des Frequenzbereichs.	Steuert die Breite des Frequenzbands. Je höher der `Q`-Wert, desto kleiner das Frequenzband.	Nicht verwendet
`lowshelf`	Standardmäßiger zweiter Ordnung Tiefenreglerfilter. Frequenzen unterhalb der Frequenz werden verstärkt oder abgeschwächt; Frequenzen darüber bleiben unverändert.	Das obere Limit der Frequenzen, die verstärkt oder abgeschwächt werden.	Nicht verwendet	Die Verstärkung in dB, die angewendet wird; wenn negativ, ist es eine Abschwächung.
`highshelf`	Standardmäßiger zweiter Ordnung Höhenreglerfilter. Frequenzen über der Frequenz werden verstärkt oder abgeschwächt; Frequenzen darunter bleiben unverändert.	Das untere Limit der Frequenzen, die verstärkt oder abgeschwächt werden.	Nicht verwendet	Die Verstärkung in dB, die angewendet wird; wenn negativ, ist es eine Abschwächung.
`peaking`	Frequenzen innerhalb des Bereichs werden verstärkt oder abgeschwächt; Frequenzen außerhalb bleiben unverändert.	Die Mitte des Frequenzbereichs, der verstärkt oder abgeschwächt wird.	Steuert die Breite des Frequenzbands. Je höher der `Q`-Wert, desto kleiner das Frequenzband.	Die Verstärkung in dB, die angewendet wird; wenn negativ, ist es eine Abschwächung.
`notch`	Standardmäßiger Kerbfilter, auch bekannt als Bandstopp oder Bandabweisungsfilter. Er ist das Gegenteil eines Bandpassfilters: Frequenzen außerhalb des gegebenen Frequenzbereichs passieren; Frequenzen innerhalb werden abgeschwächt.	Das Zentrum des Frequenzbereichs.	Steuert die Breite des Frequenzbands. Je höher der `Q`-Wert, desto kleiner das Frequenzband.	Nicht verwendet
`allpass`	Standardmäßiger zweiter Ordnung Allpassfilter. Es lässt alle Frequenzen durch, ändert jedoch die Phasenbeziehung zwischen den verschiedenen Frequenzen.	Die Frequenz mit maximalem Gruppenverzögerung, das ist, die Frequenz, bei der das Zentrum der Phasenübergang erfolgt.	Steuert, wie scharf der Übergang bei der mittleren Frequenz ist. Je größer dieser Parameter ist, desto schärfer und größer ist der Übergang.	Nicht verwendet

Instanz-Methoden

Erbt Methoden von seinem Elternteil, AudioNode.

BiquadFilterNode.getFrequencyResponse(): Diese Methode berechnet die Frequenzantwort auf Basis der aktuellen Filterparametereinstellungen für die in dem bereitgestellten Frequenzarray angegebenen Frequenzen.

Beispiel

Sehen Sie AudioContext.createBiquadFilter für Beispielcode, der zeigt, wie ein AudioContext verwendet wird, um einen Biquad-Filterknoten zu erstellen.

Spezifikationen

Specification
Web Audio API # BiquadFilterNode

Browser-Kompatibilität

Siehe auch

Verwendung der Web Audio API