Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

GainNode — ovládání amplitudy zvuku

GainNode násobí zvukové vzorky parametrem gain, a umožňuje tak ztlumení, zesílení a automatizaci amplitudy.

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

Syntaxe

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

GainNode je uzel rozhraní Web Audio API s jedním vstupem a jedním výstupem. Každý vzorek každého kanálu násobí hodnotou gain: 1 zachovává amplitudu, 0 zvuk ztlumí a záporná hodnota obrátí polaritu. Násobení je lineární, nikoli vyjádřené v decibelech.

gain je objekt AudioParam s výchozí hodnotou 1 a frekvencí automatizace a-rate. Měňte gain.value, místo abyste přiřazovali číslo do gain. K plynulým přechodům použijte například gain.linearRampToValueAtTime(value, time); náhlé změny mohou způsobit cvaknutí.

Jde o rozhraní prohlížeče, nikoli o součást ECMAScriptu; přítomnost Node.js nedokazuje, že je toto rozhraní dostupné.

Příklady

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

Výsledek

[0.125,-0.125,0.25,-0.25]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje