База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

AudioNode — възли и връзки в аудиографа

AudioNode е базовият интерфейс за възлите на Web Audio. Методът connect() насочва обработката на звук или управлява аудиопараметър.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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 е базовият интерфейс за източници, процесори и изходи в граф на Web Audio. Създавайте конкретни възли, например чрез context.createGain(), вместо да използвате new AudioNode(). Това е API на браузъра, а не част от ECMAScript; наличието на Node 24 не потвърждава, че API е достъпен.

AudioNode.connect, извикан като node.connect(...), свързва изход с входа на друг възел или с AudioParam. Вариантът с възел връща целта и позволява свързване на извикванията във верига; вариантът с AudioParam връща undefined. Индексите на портовете по подразбиране са 0; те не са номера на канали. Различните контексти причиняват InvalidAccessError, а индексите извън допустимия диапазон причиняват IndexSizeError. Повторното идентично свързване се игнорира.

Примери

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

Резултат

128 true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници