The AudioDestinationNode
interface represents the end destination of an audio graph in a given context — usually the speakers of your device. It can also be the node that will "record" the audio data when used with an OfflineAudioContext
.
AudioDestinationNode
has no output (as it is the output, no more AudioNode
can be linked after it in the audio graph) and one input. The amount of channels in the input must be between 0
and the maxChannelCount
value or an exception is raised.
The AudioDestinationNode
of a given AudioContext
can be retrieved using the AudioContext.destination
property.
Number of inputs | 1 |
---|---|
Number of outputs | 0 |
Channel count mode | "explicit" |
Channel count | 2 |
Channel interpretation | "speakers" |
Properties
Inherits properties from its parent, AudioNode
.
AudioDestinationNode.maxChannelCount
- Is an
unsigned long
defining the maximum amount of channels that the physical device can handle.
Methods
No specific method; inherits methods from its parent, AudioNode
.
Example
There is no complex set up for using an AudioDestinationNode
— by default, this simply represents the output of the user's system (e.g. their speakers), so you can get it hooked up inside an audio graph using only a few lines of code:
var audioCtx = new AudioContext(); var source = audioCtx.createMediaElementSource(myMediaElement); source.connect(gainNode); gainNode.connect(audioCtx.destination);
To see a more complete implementation, check out one of our MDN Web Audio examples, such as Voice-change-o-matic or Violent Theremin.
Specifications
Specification | Status | Comment |
---|---|---|
Web Audio API The definition of 'AudioDestinationNode' in that specification. |
Working Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 14 webkit | 23 | Not supported | 15 webkit 22 (unprefixed) |
6 webkit |
Feature | Android | Chrome | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | Not supported | 28 webkit | 25 | 1.2 | Not supported | Not supported | 6 webkit |