CKTIS / JavaScript
GainNode — controlar a amplitude do áudio
GainNode multiplica as amostras de áudio pelo parâmetro gain, permitindo silenciar, amplificar e automatizar a amplitude.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const node = new GainNode(context, { gain: 0.5 });
// Alternative:
const node2 = context.createGain();
node2.gain.value = 0.5;GainNode é um nó da Web Audio API com uma entrada e uma saída. Multiplica cada amostra de cada canal por gain: 1 mantém a amplitude, 0 silencia e um valor negativo inverte a polaridade. O multiplicador é linear, não é medido em decibéis.
gain é um objeto AudioParam, com o valor predefinido 1 e uma taxa de automação a-rate. Altera gain.value em vez de atribuíres um número a gain. Para transições suaves, usa métodos como gain.linearRampToValueAtTime(value, time); alterações bruscas podem causar estalidos.
Esta é uma API de navegador, não faz parte do ECMAScript; a presença de Node.js não comprova que esteja disponível.
Exemplos
(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))
));
})();Resultado
[0.125,-0.125,0.25,-0.25]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.