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)
Parameter
context-
Ein Verweis auf einen
AudioContext. optionsOptional-
Optionen sind wie folgt:
buffer-
Ein mono, stereo oder 4-Kanal
AudioBuffer, der die (möglicherweise mehrkanalige) Impulsantwort enthält, die vomConvolverNodeverwendet 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.channelCountfür weitere Informationen.) Seine Nutzung und genaue Definition hängen vom Wert vonchannelCountModeab. 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.channelCountModefü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". (SieheAudioNode.channelCountModefür weitere Informationen, einschließlich der Standardwerte.)
Rückgabewert
Eine neue Instanz des ConvolverNode-Objekts.
Ausnahmen
NotSupportedErrorDOMException-
Wird ausgelöst, wenn der referenzierte
AudioBuffernicht die richtige Anzahl an Kanälen hat oder eine andere Abtastrate als der zugehörigeAudioContextaufweist.
Spezifikationen
| Specification |
|---|
| Web Audio API> # dom-convolvernode-convolvernode> |