ChannelMergerNode: ChannelMergerNode() 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 ChannelMergerNode() constructor creates a new ChannelMergerNode object instance.
Syntax
new ChannelMergerNode(context)
new ChannelMergerNode(context, options)
Parameters
context-
A
BaseAudioContextrepresenting the audio context you want the node to be associated with. optionsOptional-
An object defining the properties you want the
ChannelMergerNodeto have:numberOfInputsOptional-
A number defining the number of inputs the
ChannelMergerNodeshould have. If not specified, the default value used is 6. channelCountOptional-
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. channelCountModeOptional-
A string describing the way channels must be matched between the node's inputs and outputs. (See
AudioNode.channelCountModefor more information including default values.) channelInterpretationOptional-
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.channelCountModefor more information including default values.)
Return value
A new ChannelMergerNode object instance.
Exceptions
InvalidStateErrorDOMException-
Thrown if an option such as
channelCountorchannelCountModehas been given an invalid value.
Examples
const ac = new AudioContext();
const options = {
numberOfInputs: 2,
};
const myMerger = new ChannelMergerNode(ac, options);
Specifications
| Specification |
|---|
| Web Audio API> # dom-channelmergernode-channelmergernode> |