CKTIS / JavaScript
GainNode — uravnavanje zvočne amplitude
GainNode množi zvočne vzorce s parametrom gain, kar omogoča utišanje, ojačanje in avtomatizacijo amplitude.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const node = new GainNode(context, { gain: 0.5 });
// Alternative:
const node2 = context.createGain();
node2.gain.value = 0.5;GainNode je vozlišče vmesnika Web Audio API z enim vhodom in enim izhodom. Vsak vzorec vsakega kanala množi z vrednostjo gain: 1 ohrani amplitudo, 0 utiša zvok, negativna vrednost pa obrne polarnost. Množenje je linearno in ni izraženo v decibelih.
gain je objekt AudioParam s privzeto vrednostjo 1 in hitrostjo avtomatizacije a-rate. Spreminjajte gain.value, namesto da številko dodelite gain. Za gladke prehode uporabite na primer gain.linearRampToValueAtTime(value, time); nenadne spremembe lahko povzročijo klike.
To je API brskalnika in ni del ECMAScript; prisotnost Node.js ne dokazuje, da je API na voljo.
Primeri
(async () => {
const context = new OfflineAudioContext(1, 128, 48000);
const buffer = context.createBuffer(1, 128, 48000);
buffer.getChannelData(0).set([0.5, -0.5, 1, -1]);
const source = context.createBufferSource();
source.buffer = buffer;
const gain = new GainNode(context, { gain: 0.25 });
source.connect(gain).connect(context.destination);
source.start(0);
const rendered = await context.startRendering();
console.log(JSON.stringify(
Array.from(rendered.getChannelData(0).slice(0, 4))
));
})();Rezultat
[0.125,-0.125,0.25,-0.25]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.