Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

GainNode — regulacja amplitudy dźwięku

GainNode mnoży próbki dźwięku przez parametr gain, umożliwiając wyciszanie, wzmacnianie i automatyzację amplitudy.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const node = new GainNode(context, { gain: 0.5 });
// Alternative:
const node2 = context.createGain();
node2.gain.value = 0.5;

GainNode to węzeł Web Audio API z jednym wejściem i jednym wyjściem. Mnoży każdą próbkę każdego kanału przez gain: 1 zachowuje amplitudę, 0 wycisza, a wartość ujemna odwraca polaryzację. Mnożnik jest liniowy, nie wyrażony w decybelach.

gain jest obiektem AudioParam, domyślnie o wartości 1 i częstotliwości automatyzacji a-rate. Zmieniaj gain.value, nie przypisuj liczby do gain. Do płynnych przejść służy np. gain.linearRampToValueAtTime(value, time); nagłe zmiany mogą powodować trzaski.

To API przeglądarkowe, nie część ECMAScript; obecność Node.js nie dowodzi jego dostępności.

Przykłady

(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))
  ));
})();

Wynik

[0.125,-0.125,0.25,-0.25]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła