AudioNode

« AudioNode

An AudioNode has inputs and outputs, each with a given amount of channels. An AudioNode with zero inputs and exactly one output is called a source node. The exactly processing done varies from one AudioNode to another but, in general, a node reads its inputs, does some audio-related processing, and generates new values for its outputs.

Different nodes can be linked together to build a processing graph. Such a graph is contained in an AudioContext. Each AudioNode participates in exactly one such context. In general, processing nodes inherit the properties and methods of AudioNode, but also define their own functionality on top. See the individual node pages for more details, as listed on the Web Audio API homepage.

属性

AudioNode.context 読取専用

Returns the associated AudioContext, that is the object representing the processing graph the node is participating in.

AudioNode.numberOfInputs 読取専用

Returns the number of inputs feeding the node. Source nodes are defined as nodes having a numberOfInputs property with a value of 0.

AudioNode.numberOfOutputs 読取専用

Returns the number of outputs coming out of the node. Destination nodes — like AudioDestinationNode — have a value of 0 for this attribute.

AudioNode.channelCount

Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node. Its usage and precise definition depend on the value of AudioNode.channelCountMode.

AudioNode.channelCountMode

Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs.

AudioNode.channelInterpretation

Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen.
The possible values are "speakers" or "discrete".

メソッド

Also implements methods from the interface EventTarget.

AudioNode.connect(AudioNode)

Allows us to connect one output of this node to one input of another node.

AudioNode.connect(AudioParam)

Allows us to connect one output of this node to one input of an audio parameter.

AudioNode.disconnect()

Allows us to disconnect the current node from another one it is already connected to.

例

This simple snippet of code shows the creation of some audio nodes, and how the AudioNode properties and methods can be used. You can find examples of such usage on any of the examples linked to on the Web Audio API landing page (for example 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;

使用

ブラウザ互換性

関連情報

• Web Audio API の利用