Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

AudioNode — węzły i połączenia grafu audio

AudioNode to bazowy interfejs węzłów Web Audio. Metoda connect() łączy przetwarzanie dźwięku lub steruje parametrem audio.

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

Składnia

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 jest bazowym interfejsem źródeł, procesorów i wyjść grafu Web Audio. Twórz konkretne węzły, np. przez context.createGain(), zamiast new AudioNode(). To API przeglądarki, nie część ECMAScript; obecność Node 24 nie potwierdza jego dostępności.

AudioNode.connect, wywoływane jako node.connect(...), łączy wyjście z wejściem innego węzła albo z AudioParam. Wariant z węzłem zwraca cel, umożliwiając łańcuchy; wariant z AudioParam zwraca undefined. Indeksy portów domyślnie wynoszą 0; nie są numerami kanałów. Różne konteksty powodują InvalidAccessError, a indeksy poza zakresem — IndexSizeError. Powtórzenie identycznego połączenia jest ignorowane.

Przykłady

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

Wynik

128 true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła