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

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
gain

Legend

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

Full support
Full support

Siehe auch