ConvolverNode: ConvolverNode() 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 ConvolverNode() Konstruktor der Web Audio API erstellt eine neue ConvolverNode Objektinstanz.

new ConvolverNode(context, options)

Eine Referenz zu einem AudioContext.

Optionen sind wie folgt:

buffer: Ein mono, stereo oder 4-Kanal AudioBuffer, der die (möglicherweise mehrkanalige) Impulsantwort enthält, die vom ConvolverNode verwendet wird, um den Halleffekt zu erzeugen.
disableNormalization: Ein boolescher Wert, der steuert, ob die Impulsantwort aus dem Buffer durch eine Gleichleistungs-Normalisierung skaliert wird oder nicht. Standardmäßig ist dies false.
channelCount: Stellt eine ganze Zahl dar, die festlegt, wie viele Kanäle beim Up-Mixing und Down-Mixing von Verbindungen zu Eingaben des Knoten verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Die Verwendung und genaue Definition hängen vom Wert von channelCountMode ab.
channelCountMode: Stellt einen enumerierten Wert dar, der beschreibt, wie die Kanäle zwischen den Eingaben und Ausgaben des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)
channelInterpretation: Stellt einen enumerierten Wert dar, der die Bedeutung der Kanäle beschreibt. Diese Interpretation bestimmt, wie Audio up-mixing und down-mixing durchgeführt wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)

Eine neue ConvolverNode Objektinstanz.

NotSupportedError DOMException: Wird ausgelöst, wenn der referenzierte AudioBuffer nicht die korrekte Anzahl von Kanälen hat oder wenn er eine andere Abtastrate als der zugehörige AudioContext hat.

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

BCD tables only load in the browser