Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

GainNode — upravljanje amplitudom zvuka

GainNode množi zvučne uzorke parametrom gain, što omogućuje stišavanje, pojačavanje i automatizaciju amplitude.

Verzija: 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 čvor Web Audio API-ja s jednim ulazom i jednim izlazom. Svaki uzorak svakog kanala množi vrijednošću gain: 1 zadržava amplitudu, 0 stišava zvuk, a negativna vrijednost obrće polaritet. Množenje je linearno, a ne izraženo u decibelima.

gain je objekt AudioParam sa zadanom vrijednošću 1 i frekvencijom automatizacije a-rate. Mijenjajte gain.value, umjesto da broj dodjeljujete objektu gain. Za postupne prijelaze upotrijebite, primjerice, gain.linearRampToValueAtTime(value, time); nagle promjene mogu uzrokovati pucketanje.

Ovo je API preglednika, a ne dio ECMAScripta; sama prisutnost Node.js-a ne dokazuje da je API dostupan.

Primjeri

(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]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori