BiquadFilterNode: gain-Eigenschaft

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 gain-Eigenschaft des BiquadFilterNode-Interfaces ist ein a-rate AudioParam — ein Doppelwert, der den in der aktuellen Filteralgorithmus verwendeten gain repräsentiert.

Wenn ihr Wert positiv ist, stellt sie einen tatsächlichen Gain dar; wenn negativ, stellt sie eine Abschwächung dar.

Sie wird in dB ausgedrückt, hat einen Standardwert von 0 und kann einen Wert in einem nominalen Bereich von -40 bis 40 annehmen.

Wert

Ein AudioParam.

Hinweis: Obwohl das zurückgegebene AudioParam schreibgeschützt ist, ist der von ihm dargestellte Wert dies nicht.

Beispiele

Das folgende Beispiel zeigt die grundlegende Verwendung eines AudioContext, um einen Biquad-Filterknoten zu erstellen. Für vollständigere angewandte Beispiele/Informationen werfen Sie einen Blick auf unser Voice-change-O-matic-Demo (siehe app.js lines 108–193 für relevanten Code).

js
const audioCtx = new AudioContext();

//set up the different audio nodes we will use for the app
const analyser = audioCtx.createAnalyser();
const distortion = audioCtx.createWaveShaper();
const gainNode = audioCtx.createGain();
const biquadFilter = audioCtx.createBiquadFilter();
const convolver = audioCtx.createConvolver();

// connect the nodes together

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyser);
analyser.connect(distortion);
distortion.connect(biquadFilter);
biquadFilter.connect(convolver);
convolver.connect(gainNode);
gainNode.connect(audioCtx.destination);

// Manipulate the Biquad filter

biquadFilter.type = "lowshelf";
biquadFilter.frequency.value = 1000;
biquadFilter.gain.value = 25;

Spezifikationen

Specification
Web Audio API
# dom-biquadfilternode-gain

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch