База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

GainNode — управление на аудио амплитудата

GainNode умножава аудио семплите по параметъра gain, което позволява заглушаване, усилване и автоматизиране на амплитудата.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

GainNode е възел от Web Audio API с един вход и един изход. Той умножава всеки семпъл на всеки канал по gain: 1 запазва амплитудата, 0 заглушава звука, а отрицателна стойност обръща полярността. Множителят е линеен, а не измерен в децибели.

gain е обект AudioParam със стойност по подразбиране 1 и честота на автоматизация a-rate. Променяйте gain.value, вместо да присвоявате число на gain. За плавни преходи използвайте например gain.linearRampToValueAtTime(value, time); резките промени могат да причинят щраквания.

Това е API на браузъра, а не част от ECMAScript; наличието на Node.js не доказва, че API е достъпен.

Примери

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

Резултат

[0.125,-0.125,0.25,-0.25]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници