AudioDestinationNode

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 webkit

See also

Document Tags and Contributors

Contributors to this page: fscholz, padenot, chrisdavidmills, pchng, teoli, kscarfone
Last updated by: fscholz,