AudioDestinationNode

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

AudioDestinationNode インターフェイスは、指定のコンテキストの音声の最後の目的地、通常は端末のスピーカーを表します。OfflineAudioContext と共に使えば、オーディオデータを「録音」するノードにもできます。

AudioDestinationNode には出力はなく（出力があれば、これ以上 AudioNode に音声を結びつけることができません）、入力が 1 つあります。入力チャンネルの数は、0 から maxChannelCount 変数の間である必要があり、そうでなければ例外が発生します。

指定された AudioContext の AudioDestinationNode は AudioContext.destination プロパティで取得できます。

入力数	`1`
出力数	`0`
チャンネルの数え方	`"explicit"`
チャンネル数	`2`
チャンネルの意味	`"speakers"`

プロパティ

親である AudioNode から継承したプロパティがあります。

AudioDestinationNode.maxChannelCount: unsigned long で、この物理機器が扱うことができるチャンネルの最大数を定義します。

メソッド

固有のメソッドはありません。親である AudioNode から継承したメソッドがあります。

例

AudioDestinationNode の設定には複雑なことはありません。既定でユーザーのシステム（例:スピーカー）を表します。よって、数行のコードを書くだけで内部の音声を接続することができます。

const audioCtx = new AudioContext();
const source = audioCtx.createMediaElementSource(myMediaElement);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);

完全な実装は、MDN Web Audio の Voice-change-o-matic や Violent Theremin のような例を参考にしてください。