MediaElementAudioSourceNode: MediaElementAudioSourceNode() constructor
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.
The MediaElementAudioSourceNode() constructor creates a new MediaElementAudioSourceNode object instance.
Syntax
new MediaElementAudioSourceNode(context, options)
Parameters
context-
An
AudioContextrepresenting the audio context you want the node to be associated with. options-
An object defining the properties you want the
MediaElementAudioSourceNodeto have:mediaElement-
An
HTMLMediaElementthat will be used as the source for the audio. channelCount-
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.channelCountfor more information.) Its usage and precise definition depend on the value ofchannelCountMode. channelCountMode-
A string describing the way channels must be matched between the node's inputs and outputs. (See
AudioNode.channelCountModefor more information including default values.) channelInterpretation-
A string 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". (SeeAudioNode.channelInterpretationfor more information including default values.)
Return value
A new MediaElementAudioSourceNode object instance.
Examples
const ac = new AudioContext();
const mediaElement = document.createElement("audio");
const myAudioSource = new MediaElementAudioSourceNode(ac, {
mediaElement,
});
Specifications
| Specification |
|---|
| Web Audio API # dom-mediaelementaudiosourcenode-mediaelementaudiosourcenode |