BiquadFilterNode

Baseline Widely available

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

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

EventTarget AudioNode BiquadFilterNode
Anzahl der Eingänge 1
Anzahl der Ausgänge 1
Kanalanzahl-Modus "max"
Kanalanzahl 2 (nicht im Standardanzahl-Modus verwendet)
Kanalinterpretation "speakers"

Konstruktor

BiquadFilterNode()

Erstellt eine neue Instanz eines BiquadFilterNode-Objekts.

Instanz-Eigenschaften

Übernimmt Eigenschaften von seinem Elternteil, AudioNode.

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

BiquadFilterNode.frequency Nur lesbar

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

BiquadFilterNode.detune Nur lesbar

Ein a-rate AudioParam, das die Verstimmung der Frequenz in Cent darstellt.

BiquadFilterNode.Q Nur lesbar

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

BiquadFilterNode.gain Nur lesbar

Ein a-rate AudioParam, ein Doppelwert, der die im aktuellen Filteralgorithmus verwendete Verstärkung darstellt.

BiquadFilterNode.type

Ein Zeichenfolgenwert, der die Art des vom Knoten implementierten Filteralgorithmus definiert.

Die Bedeutung der verschiedenen Parameter je nach Art des Filters (Detune hat unabhängig davon, die gleiche Bedeutung, daher unten nicht aufgeführt)
type Beschreibung frequency Q gain
lowpass Standardmäßiger Resonanz-Tiefpassfilter zweiter Ordnung mit 12dB/Oktave Abfall. Frequenzen unterhalb der Grenzfrequenz passieren; Frequenzen darüber werden abgeschwächt. Die Grenzfrequenz. Gibt an, wie stark die Frequenz um die Grenzfrequenz ausgeprägt ist. Je größer der Wert, desto größer ist der Spitzenwert. Nicht verwendet
highpass Standardmäßiger Resonanz-Hochpassfilter zweiter Ordnung mit 12dB/Oktave Abfall. Frequenzen unterhalb der Grenzfrequenz werden abgeschwächt; Frequenzen darüber passieren. Die Grenzfrequenz. Gibt an, wie stark die Frequenz um die Grenzfrequenz ausgeprägt ist. Je größer der Wert, desto größer ist der Spitzenwert. Nicht verwendet
bandpass Standardmäßiger Bandpassfilter zweiter Ordnung. Frequenzen außerhalb des angegebenen Bereichs werden abgeschwächt; die Frequenzen innerhalb davon passieren. Die Mitte des Frequenzbereichs. Steuert die Breite des Frequenzbandes. Je größer der Q-Wert, desto kleiner das Frequenzband. Nicht verwendet
lowshelf Standardmäßiger Lowshelf-Filter zweiter Ordnung. Frequenzen unterhalb der Frequenz erhalten eine Verstärkung oder eine Abschwächung; Frequenzen darüber bleiben unverändert. Die obere Grenze der Frequenzen, die eine Verstärkung oder Abschwächung erhalten. Nicht verwendet Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein.
highshelf Standardmäßiger Highshelf-Filter zweiter Ordnung. Frequenzen oberhalb der Frequenz erhalten eine Verstärkung oder Abschwächung; Frequenzen darunter bleiben unverändert. Die untere Grenze der Frequenzen, die eine Verstärkung oder Abschwächung erhalten. Nicht verwendet Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein.
peaking Frequenzen innerhalb des Bereichs erhalten eine Verstärkung oder Abschwächung; Frequenzen außerhalb davon bleiben unverändert. Die Mitte des Frequenzbereichs, der eine Verstärkung oder Abschwächung erhält. Steuert die Breite des Frequenzbandes. Je größer der Q-Wert, desto kleiner das Frequenzband. Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein.
notch Standardmäßiger Notch- Filter, auch als Band-Stop- oder Band-Rejection-Filter bezeichnet. Es ist das Gegenteil eines Bandpass-Filters: Frequenzen außerhalb des angegebenen Frequenzbereichs passieren; Frequenzen innerhalb davon werden abgeschwächt. Die Mitte des Frequenzbereichs. Steuert die Breite des Frequenzbandes. Je größer der Q-Wert, desto kleiner das Frequenzband. Nicht verwendet
allpass Standardmäßiger Allpass- Filter zweiter Ordnung. Er lässt alle Frequenzen durch, verändert jedoch die Phasenbeziehung zwischen den verschiedenen Frequenzen. Die Frequenz mit der maximalen Gruppenlaufzeit, das heißt die Frequenz, bei der das Zentrum der Phasenverschiebung auftritt. Steuert, wie scharf der Übergang bei der mittleren Frequenz ist. Je größer dieser Parameter ist, desto schärfer und größer wird der Übergang sein. Nicht verwendet

Instanz-Methoden

Übernimmt Methoden von seinem Elternteil, AudioNode.

BiquadFilterNode.getFrequencyResponse()

Diese Methode berechnet aus den aktuellen Filterparameter-Einstellungen die Frequenzantwort für die in dem bereitgestellten Frequenzarray angegebenen Frequenzen.

Beispiel

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

Spezifikationen

Specification
Web Audio API
# BiquadFilterNode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch