CKTIS / JavaScript
GainNode — ovládanie amplitúdy zvuku
GainNode násobí zvukové vzorky parametrom gain, čím umožňuje stíšenie, zosilnenie a automatizáciu amplitúdy.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const node = new GainNode(context, { gain: 0.5 });
// Alternative:
const node2 = context.createGain();
node2.gain.value = 0.5;GainNode je uzol rozhrania Web Audio API s jedným vstupom a jedným výstupom. Každú vzorku každého kanála násobí hodnotou gain: 1 zachová amplitúdu, 0 stíši zvuk a záporná hodnota obráti polaritu. Násobenie je lineárne, nie vyjadrené v decibeloch.
gain je objekt AudioParam s predvolenou hodnotou 1 a frekvenciou automatizácie a-rate. Meňte gain.value, namiesto toho, aby ste priradili číslo do gain. Na plynulé prechody použite napríklad gain.linearRampToValueAtTime(value, time); náhle zmeny môžu spôsobiť praskanie.
Ide o rozhranie prehliadača, nie o súčasť ECMAScriptu; prítomnosť Node.js nedokazuje, že je toto rozhranie dostupné.
Príklady
(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))
));
})();Výsledok
[0.125,-0.125,0.25,-0.25]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.