Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

GainNode — controlar la amplitud del audio

GainNode multiplica las muestras de audio por el parámetro gain, lo que permite silenciar, amplificar y automatizar la amplitud.

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

Sintaxis

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

GainNode es un nodo de la Web Audio API con una entrada y una salida. Multiplica cada muestra de cada canal por gain: 1 conserva la amplitud, 0 silencia y un valor negativo invierte la polaridad. El multiplicador es lineal, no se mide en decibelios.

gain es un objeto AudioParam con un valor predeterminado de 1 y automatización de tipo a-rate. Cambia gain.value en lugar de asignar un número a gain. Para obtener transiciones suaves, usa métodos como gain.linearRampToValueAtTime(value, time); los cambios bruscos pueden producir chasquidos.

Esta es una API de navegador, no forma parte de ECMAScript; disponer de Node.js no demuestra que esté disponible.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes