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 July 2015.

Die gain-Eigenschaft des BiquadFilterNode-Interface ist ein a-rate AudioParam – ein Double, das den in dem aktuellen Filteralgorithmus verwendeten Verstärkungsfaktor darstellt.

Wenn sein Wert positiv ist, stellt er eine echte Verstärkung dar; wenn negativ, stellt er eine Dämpfung dar.

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

Wert

Ein AudioParam.

Hinweis: Obwohl das zurückgegebene AudioParam schreibgeschützt ist, ist der Wert, den es darstellt, es nicht.

Beispiele

Das folgende Beispiel zeigt die grundlegende Verwendung eines AudioContext, um einen Biquad-Filterknoten zu erstellen. Für ausführlichere Anwendungsbeispiele/Informationen sehen Sie sich unser Voice-change-O-matic Demo an (siehe app.js Zeilen 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

Siehe auch