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

js
createConvolver()

Parameter

Keine.

Rückgabewert

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).

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createConvolver

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch