IIRFilterNode: IIRFilterNode() Konstruktor

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.

Der IIRFilterNode() Konstruktor der Web Audio API erstellt ein neues IIRFilterNode-Objekt, welches ein AudioNode-Prozessor ist, der einen allgemeinen Infinite-Impulse-Response-Filter implementiert.

Syntax

js
new IIRFilterNode(context, options)

Parameter

context

Eine Referenz zu einem AudioContext.

options

Die Optionen sind wie folgt:

feedforward

Eine Sequenz von Feedforward-Koeffizienten.

feedback

Eine Sequenz von Feedback-Koeffizienten.

channelCount

Stellt eine ganze Zahl dar, die verwendet wird, um zu bestimmen, wie viele Kanäle bei Up-Mixing und Down-Mixing verwendet werden, um Verbindungen zu Eingängen des Knotens herzustellen. (Siehe AudioNode.channelCount für weitere Informationen.) Seine Nutzung und genaue Definition hängen vom Wert von channelCountMode ab.

channelCountMode

Stellt einen enumerierten Wert dar, der beschreibt, wie die Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für mehr Informationen einschließlich der Standardwerte.)

channelInterpretation

Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation definiert, wie Audio Up-Mixing und Down-Mixing durchgeführt werden. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen einschließlich der Standardwerte.)

Im Gegensatz zu anderen Knoten in der Web Audio API sind die Optionen, die beim Erstellen des IIR-Filters übergeben werden, nicht optional. Der Filter benötigt diese Werte zur Funktion und aufgrund des großen Spektrums verfügbarer Filter gibt es keine Vorgabewerte.

Rückgabewert

Eine neue Instanz des IIRFilterNode-Objekts.

Beispiele

js
let feedForward = [0.00020298, 0.0004059599, 0.00020298];
let feedBackward = [1.0126964558, -1.9991880801, 0.9873035442];

const audioCtx = new AudioContext();

const iirFilter = new IIRFilterNode(audioCtx, {
  feedforward: feedForward,
  feedback: feedBackward,
});

Spezifikationen

Specification
Web Audio API
# dom-iirfilternode-constructor-iirfilternode

Browser-Kompatibilität

BCD tables only load in the browser