The ChannelMergerNode()
constructor creates a new ChannelMergerNode
object instance.
On this page
ChannelMergerNode: ChannelMergerNode() constructor
Syntax
js
new ChannelMergerNode(context)
new ChannelMergerNode(context, options)
Parameters
-
context
-
A
BaseAudioContext
representing the audio context you want the node to be associated with. options
Optional-
An object defining the properties you want the
ChannelMergerNode
to have:numberOfInputs
Optional-
A number defining the number of inputs the
ChannelMergerNode
should have. If not specified, the default value used is 6. channelCount
Optional-
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 ofchannelCountMode
. channelCountMode
Optional-
A string describing the way channels must be matched between the node's inputs and outputs. (See
AudioNode.channelCountMode
for more information including default values.) channelInterpretation
Optional-
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.channelCountMode
for more information including default values.)
Return value
A new ChannelMergerNode
object instance.
Exceptions
InvalidStateError
DOMException
-
Thrown if an option such as
channelCount
orchannelCountMode
has been given an invalid value.
Examples
js
const ac = new AudioContext();
const options = {
numberOfInputs: 2,
};
const myMerger = new ChannelMergerNode(ac, options);
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ChannelMergerNode |
55 | 79 | 53 | No | 42 | 14.1 | 55 | 55 | 53 | 42 | 14.5 | 6.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ChannelMergerNode/ChannelMergerNode