IIRFilterNode
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.
Die IIRFilterNode-Schnittstelle der Web Audio API ist ein AudioNode-Prozessor, der einen allgemeinen Infinite Impulse Response (IIR)-Filter implementiert; dieser Filtertyp kann auch verwendet werden, um Klangregelgeräte und grafische Equalizer zu implementieren. Sie ermöglicht es, die Parameter der Filterantwort zu spezifizieren, sodass sie je nach Bedarf angepasst werden kann.
| Anzahl der Eingänge | 1 |
|---|---|
| Anzahl der Ausgänge | 1 |
| Kanalanzahlmodus | "max" |
| Kanalanzahl | Gleich wie beim Eingang |
| Kanalinterpretation | "speakers" |
Typischerweise ist es am besten, die BiquadFilterNode-Schnittstelle zu verwenden, um höherwertige Filter zu implementieren. Dafür gibt es mehrere Gründe:
- Biquad-Filter sind typischerweise weniger anfällig für numerische Eigenheiten.
- Die Filterparameter von Biquad-Filtern können automatisiert werden.
- Alle gerade geordneten IIR-Filter können mit
BiquadFilterNodeerstellt werden.
Wenn Sie jedoch einen ungerade geordneten IIR-Filter erstellen müssen, müssen Sie IIRFilterNode verwenden. Diese Schnittstelle kann auch nützlich sein, wenn Sie keine Automatisierung benötigen oder aus anderen Gründen.
Hinweis: Sobald der Knoten erstellt wurde, können Sie seine Koeffizienten nicht mehr ändern.
IIRFilterNodes haben eine Tail-Time-Referenz; sie geben weiterhin nicht-stille Audiodaten mit Null-Eingang aus. Als IIR-Filter setzt sich der nicht-null Input theoretisch unendlich fort, aber dies kann in der Praxis nach einer begrenzten Zeit begrenzt werden, wenn die Ausgabe nahe genug an Null herangekommen ist. Die tatsächliche Dauer hängt von den bereitgestellten Filterkoeffizienten ab.
Konstruktor
IIRFilterNode()-
Erstellt eine neue Instanz eines IIRFilterNode-Objekts.
Instanzeigenschaften
Diese Schnittstelle hat keine eigenen Eigenschaften; sie erbt jedoch Eigenschaften von ihrem Elternteil, AudioNode.
Instanzmethoden
Erbt Methoden von ihrem Elternteil, AudioNode. Sie hat auch die folgenden zusätzlichen Methoden:
getFrequencyResponse()-
Nutzt die aktuellen Parametereinstellungen des Filters, um die Antwort für die in dem bereitgestellten Frequenzarray angegebenen Frequenzen zu berechnen.
Beispiele
Sie finden eine einfache IIR-Filter-Demo live. Sehen Sie sich auch den Quellcode auf GitHub an. Es enthält einige verschiedene Koeffizientenwerte für verschiedene Tiefpassfrequenzen — Sie können den Wert der filterNumber Konstante auf einen Wert zwischen 0 und 3 ändern, um die verschiedenen verfügbaren Effekte auszuprobieren.
Siehe auch unseren Leitfaden zur Verwendung von IIR-Filtern für eine vollständige Erklärung.
Spezifikationen
| Specification |
|---|
| Web Audio API # IIRFilterNode |