MediaElementAudioSourceNode()

The MediaElementAudioSourceNode() constructor creates a new MediaElementAudioSourceNode object instance.

Syntax

var myAudioSource = new MediaElementAudioSourceNode(context, options);

Parameters

context

An AudioContext representing the audio context you want the node to be associated with.

options

A MediaElementAudioSourceOptions dictionary object defining the properties you want the MediaElementAudioSourceNode to have:

  • mediaElement: An HTMLMediaElement that will be used as the source for the audio.
  • 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. (See AudioNode.channelCount for more information.) Its usage and precise definition depend on the value of channelCountMode.
  • channelCountMode: Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs. (See AudioNode.channelCountMode for more information including default values.)
  • 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". (See AudioNode.channelCountMode for more information including default values.)

Return value

A new MediaElementAudioSourceNode object instance.

Example

var ac = new AudioContext();
var mediaElement = document.createElement('audio');

var options = {
  mediaElement : mediaElement
}

var myAudioSource = new MediaElementAudioSourceNode(ac, options);

Specifications

Specification
Web Audio API
# dom-mediaelementaudiosourcenode-mediaelementaudiosourcenode

Browser compatibility

BCD tables only load in the browser