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 Instanz des ConvolverNode-Objekts.

Syntax

new ConvolverNode(context, options)

Ein Verweis auf einen 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 Puffer durch eine Gleichleistungs-Normalisierung skaliert wird oder nicht. Der Standardwert ist false.
channelCount: Repräsentiert eine Ganzzahl, die bestimmt, wie viele Kanäle beim Hoch- und Heruntermischen von Verbindungen zu beliebigen Eingängen des Knotens verwendet werden. (Siehe AudioNode.channelCount für weitere Informationen.) Seine Nutzung und genaue Definition hängen vom Wert von channelCountMode ab.
channelCountMode: Repräsentiert einen enumerierten Wert, der beschreibt, wie Kanäle zwischen den Eingängen und Ausgängen des Knotens abgeglichen werden müssen. (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)
channelInterpretation: Repräsentiert einen enumerierten Wert, der die Bedeutung der Kanäle beschreibt. Diese Interpretation bestimmt, wie Hoch- und Heruntermischen von Audio erfolgen wird. Die möglichen Werte sind "speakers" oder "discrete". (Siehe AudioNode.channelCountMode für weitere Informationen, einschließlich der Standardwerte.)

Eine neue Instanz des ConvolverNode-Objekts.

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

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