---
title: AudioBuffer.copyToChannel()
slug: Web/API/AudioBuffer/copyToChannel
translation_of: Web/API/AudioBuffer/copyToChannel
---
<p>{{ APIRef("Web Audio API") }}</p>

<div>
<p><span class="seoSummary">{{ domxref("AudioBuffer") }}インターフェースの<code>copyToChannel()メソッドは、配列から指定のAudioBufferのチャンネルへと</code></span>コピーします。</p>
</div>

<h2 id="構文">構文</h2>

<pre class="syntaxbox"><em>myArrayBuffer</em>.copyToChannel(<em>source</em>, <em>channelNumber</em>, <em>startInChannel</em>);</pre>

<h3 id="引数">引数</h3>

<dl>
 <dt><em>source</em></dt>
 <dd>コピー元の{{jsxref("Float32Array")}}</dd>
 <dt><em>channelNumber</em></dt>
 <dd>コピー先のチャンネル番号。もし、<em>channelNumber</em>が{{domxref("AudioBuffer.numberOfChannels")}}以上ならば、<code>INDEX_SIZE_ERR例外が発生する。</code></dd>
 <dt><em>startInChannel {{optional_inline}}</em></dt>
 <dd>(任意) コピー先のオフセット位置。もし、<em>startInChannel</em>が{{domxref("AudioBuffer.length")}}を超えていれば、<code>INDEX_SIZE_ERR例外が発生する。</code></dd>
</dl>

<h2 id="例">例</h2>

<pre class="brush: js">var myArrayBuffer = audioCtx.createBuffer(2, frameCount, audioCtx.sampleRate);
var anotherArray = new Float32Array;
// myArrayBufferの2番目のチャンネルからコピーする
myArrayBuffer.copyFromChannel(anotherArray,1,0);
// anotherArrayから、myArrayBufferの1番目のチャンネルにコピーする。これで2つのチャンネルのデータは同じになる
myArrayBuffer.copyToChannel (anotherArray,0,0);
</pre>

<h2 id="仕様">仕様</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', '#widl-AudioBuffer-copyToChannel-void-Float32Array-source-long-channelNumber-unsigned-long-startInChannel', 'copyToChannel')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ互換性">ブラウザ互換性</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>{{CompatChrome(14.0)}} {{property_prefix("webkit")}}</td>
   <td>{{CompatGeckoDesktop(27)}}</td>
   <td>{{CompatNo}}</td>
   <td>15 {{property_prefix("webkit")}}<br>
    22 (unprefixed)</td>
   <td>6 {{property_prefix("webkit")}}</td>
  </tr>
  <tr>
   <td>Unprefixed</td>
   <td>{{CompatChrome(43.0)}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</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>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Android for Chrome</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoDesktop(25)}}</td>
   <td>1.2</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>6 {{property_prefix("webkit")}}</td>
   <td>{{CompatChrome(28.0)}} {{property_prefix("webkit")}}</td>
  </tr>
  <tr>
   <td>Unprefixed</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatChrome(43.0)}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="参考">参考</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li>
</ul>