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

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

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

BCD tables only load in the browser

Siehe auch