BaseAudioContext: Methode createConvolver()
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 createConvolver()
-Methode des BaseAudioContext
-Interfaces erstellt einen ConvolverNode
, der üblicherweise verwendet wird, um Halleffekte auf Ihr Audio anzuwenden. Weitere Informationen finden Sie in der Spezifikationsdefinition der Faltung.
Hinweis:
Der ConvolverNode()
-Konstruktor ist der empfohlene Weg, um einen ConvolverNode
zu erstellen; siehe Erstellen eines AudioNodes.
Syntax
createConvolver()
Parameter
Keine.
Rückgabewert
Ein ConvolverNode
.
Beispiele
Erstellen eines Convolver-Nodes
Das folgende Beispiel zeigt, wie Sie mit einem AudioContext einen Convolver-Node erstellen. Sie erstellen einen AudioBuffer
, der ein Tonsample enthält, das als Umgebung zur Formung der Faltung (Impulse-Response genannt) verwendet wird, und wenden diesen auf den Convolver an. Das untenstehende Beispiel verwendet ein kurzes Sample von einem Konzertsaalpublikum, sodass der angewendete Halleffekt wirklich tief und echoartig ist.
Für vollständigere angewandte Beispiele/Informationen schauen Sie sich unsere Voice-change-O-matic Demo an (siehe app.js für den untenstehend zitierten Code).
const audioCtx = new AudioContext();
// ...
const convolver = audioCtx.createConvolver();
// ...
// Grab audio track via fetch() for convolver node
try {
const response = await fetch(
"https://mdn.github.io/voice-change-o-matic/audio/concert-crowd.ogg",
);
const arrayBuffer = await response.arrayBuffer();
const decodedAudio = await audioCtx.decodeAudioData(arrayBuffer);
convolver.buffer = decodedAudio;
} catch (error) {
console.error(
`Unable to fetch the audio file: ${name} Error: ${err.message}`,
);
}
Spezifikationen
Specification |
---|
Web Audio API # dom-baseaudiocontext-createconvolver |
Browser-Kompatibilität
BCD tables only load in the browser