Revision 614619 of ChannelMergerNode

<p>{{WebAudioRef}}</p>
<div class="summary">
 <p><span class="seoSummary">The <code><strong>ChannelMergerNode</strong></code> interface, often used in conjunction with its opposite, {{domxref("ChannelSplitterNode")}}, reunites different mono input in a single outputs. Each input will be used to fill a channel of the output. This is useful for accessing each channels separately, e.g. for performing <em>channel mixing</em> where gain must be separately controlled on each channel.</span></p>
</div>
<p><img alt="" src="https://mdn.mozillademos.org/files/5259/WebAudioMerger.png" style="width: 200px; height: 151px; margin: 0px auto; display: block;" /></p>
<p>If <code>ChannelMergerNode</code> has one single output, but as many input as channels to merge; the amount of inputs is defined as a parameter of its constructor and the call to {{domxref("AudioContext.createChannelMerger()")}}. In case no value is given, it default to <code>6</code>.</p>
<p>Using this object, it is possible to create outputs with more channels than the rendering hardware is able to process. In that case, when the signal is sent to the {{domxref("AudioContext.listener")}} object, supernumerary channels will be ignored.</p>
<ul class="audionodebox">
 <li><dfn>Number of inputs</dfn> variable; default to <code>6</code>.</li>
 <li><dfn>Number of outputs</dfn> <code>1</code></li>
 <li><dfn>Channel count mode</dfn> <code>"max"</code></li>
 <li><dfn>Channel count</dfn> <code>2 </code>(not used in the default count mode)</li>
 <li><dfn>Channel interpretation</dfn> <code>"speakers"</code></li>
</ul>
<h2 id="Properties">Properties</h2>
<p><em>No specific property; inherits properties from its parent, </em><em>{{domxref("AudioNode")}}</em>.</p>
<h2 id="Methods">Methods</h2>
<p><em>No specific method; inherits methods from its parent, </em><em>{{domxref("AudioNode")}}</em>.</p>
<h2 id="Examples">Examples</h2>
<p>&nbsp;</p>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#ChannelMergerNode', 'ChannelMergerNode')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td>&nbsp;</td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<div>
 {{CompatibilityTable}}</div>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari (WebKit)</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>{{CompatVersionUnknown}}{{property_prefix("webkit")}}</td>
    <td>Activated on Nightly only</td>
    <td>{{CompatNo}}</td>
    <td>{{CompatNo}}</td>
    <td>{{CompatUnknown}}</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Phone</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>{{CompatUnknown}}</td>
    <td>Activated on Nightly only</td>
    <td>{{CompatNo}}</td>
    <td>{{CompatNo}}</td>
    <td>{{CompatUnknown}}</td>
   </tr>
  </tbody>
 </table>
</div>
<h2 id="See_also">See also</h2>
<ul>
 <li>Using Web Audio</li>
</ul>