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

CKTIS / JavaScript

AudioNode — uzly a spojení zvukového grafu

AudioNode je základní rozhraní pro uzly Web Audio. Jeho metoda connect() směruje zpracování zvuku nebo řídí zvukový parametr.

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

node.connect(destinationNode) // returns destinationNode
node.connect(destinationNode, output) // returns destinationNode
node.connect(destinationNode, output, input) // returns destinationNode
node.connect(destinationParam) // returns undefined
node.connect(destinationParam, output) // returns undefined
// Omitted output and input indices default to 0.

AudioNode je základní rozhraní pro zdroje, procesory a výstupy v grafu Web Audio. Vytvářejte konkrétní uzly, například pomocí context.createGain(), místo new AudioNode(). Jde o API prohlížeče, nikoli o součást ECMAScriptu; přítomnost Node 24 nepotvrzuje jeho dostupnost.

AudioNode.connect, volané jako node.connect(...), propojí výstup se vstupem jiného uzlu nebo s AudioParam. Varianta s uzlem vrací cíl a umožňuje řetězení volání; varianta s AudioParam vrací undefined. Indexy portů mají výchozí hodnotu 0; nejde o čísla kanálů. Různé kontexty způsobí InvalidAccessError a indexy mimo rozsah způsobí IndexSizeError. Opakované identické spojení se ignoruje.

Příklady

(async () => {
  const context = new OfflineAudioContext(1, 128, 48000);
  const buffer = context.createBuffer(1, 128, 48000);
  buffer.getChannelData(0).fill(1);

  const source = context.createBufferSource();
  source.buffer = buffer;
  const gain = context.createGain();
  gain.gain.value = 0.5;

  source.connect(gain).connect(context.destination);
  source.start(0);

  const rendered = await context.startRendering();
  const samples = rendered.getChannelData(0);
  console.log(samples.length, samples.every(value => value === 0.5));
})().catch(console.error);

Výsledek

128 true

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