AudioNode

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

* Some parts of this feature may have varying levels of support.

AudioNode это общий интерфейс для описания модулей обработки аудио таких как источники звука (например HTML элементы <audio> или <video>), генераторы звука (например OscillatorNode и т.п.), приёмники звука для модулей производящих обработку звука (например BiquadFilterNode или ConvolverNode), или регуляторы громкости (например GainNode).

AudioNodes participating in an AudioContext create a audio routing graph.

AudioNode имеет входы и выходы, каждый с заданным количеством каналов. AudioNode без входов в с одним или несколькими выходами называются источниками (source node). Результаты обработки передаются от одного AudioNode к другому, при этом каждый узел считывает только свой вход, производит обработку и представляет результат на свой выход, или просто пропускает аудио через себя (например AnalyserNode где результат представляется отдельно).

Разные узлы могут быть связаны в граф обработки. Граф помещается в AudioContext. Один AudioNode может принадлежать только одному AudioContext. В общем, узлы наследуют свойства и методы AudioNode, но они могут также и определять собственный функционал.Смотрите описания конкретных узлов на страницах этих узлов перечисленных на главной странице Web Audio API.

Примечание: An AudioNode can be target of events, therefore it implements the EventTarget interface.

Свойства

AudioNode.context Только для чтения: Возвращает связанный AudioContext, это объект, представляющий граф, в котором находится данный узел.
AudioNode.numberOfInputs Только для чтения: Возвращает количество входов узла. Узлы определённые как источники имеют numberOfInputs равное 0.
AudioNode.numberOfOutputs Только для чтения: Возвращает количество выходов узла. Узлы назначения — такие как AudioDestinationNode — имеют количество выходов равное 0.
AudioNode.channelCount: Это целое число, используемое для определения того, сколько каналов используются для up-mixing and down-mixing с любыми входами узла. Его использование точнее определяется значением AudioNode.channelCountMode.
AudioNode.channelCountMode: Это перечисление описывающее путь согласования каналов между входом и выходом.
AudioNode.channelInterpretation: Это перечисление описывающее каналы.Эта интерпретация описывает как будет происходить up-mixing and down-mixing. Возможные значения "speakers" or "discrete".

Методы

Так же реализует методы из интерфейса EventTarget.

AudioNode.connect(AudioNode): Позволяет нам подключить один выход данного узла на один вход другого узла.
AudioNode.connect(AudioParam): Позволяет нам подключить один выход данного узла на параметрический вход другого.
AudioNode.disconnect(): Позволяет нам отключить текущий узел от другого, уже подключённого узла.

Примеры

Этот простой фрагмент кода показывает создание некоторых аудио узлов, и как можно использовать свойства и методы AudioNode. Вы можете найти примеры такого использования на любом из примеров, на странице Web Audio API (например Violent Theremin.)

var AudioContext = window.AudioContext || window.webkitAudioContext;

var audioCtx = new AudioContext();

var oscillator = audioCtx.createOscillator();
var gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

oscillator.context;
oscillator.numberOfInputs;
oscillator.numberOfOutputs;
oscillator.channelCount;

Спецификации

Specification
Web Audio API # AudioNode

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

Using the Web Audio API