Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

BaseAudioContext: createIIRFilter()-Methode

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 createIIRFilter()-Methode des BaseAudioContext-Interfaces erstellt einen IIRFilterNode, der einen allgemeinen infinite impulse response (IIR)-Filter darstellt, der so konfiguriert werden kann, dass er als verschiedene Filtertypen dient.

Hinweis: Der IIRFilterNode() Konstruktor wird empfohlen, um einen IIRFilterNode zu erstellen; siehe Erstellen eines AudioNodes.

Syntax

js
createIIRFilter(feedforward, feedback)

Parameter

feedforward

Ein Array von Gleitkommawerten, das die Feedforward- (Zähler-) Koeffizienten für die Übertragungsfunktion des IIR-Filters spezifiziert. Die maximale Länge dieses Arrays beträgt 20, und mindestens ein Wert muss ungleich null sein.

feedback

Ein Array von Gleitkommawerten, das die Feedback- (Nenner-) Koeffizienten für die Übertragungsfunktion des IIR-Filters spezifiziert. Dieses Array kann bis zu 20 Elemente haben, wobei das erste nicht null sein darf.

Rückgabewert

Ein IIRFilterNode, der den Filter mit den angegebenen Feedback- und Feedforward-Koeffizientenarrays implementiert.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn alle feedforward-Koeffizienten 0 sind oder wenn der erste feedback-Koeffizient 0 ist.

NotSupportedError DOMException

Wird ausgelöst, wenn eines oder beide der Eingabearrays mehr als 20 Elemente enthalten.

Spezifikationen

Specification
Web Audio API
# dom-baseaudiocontext-createiirfilter

Browser-Kompatibilität

Siehe auch