AudioDestinationNode
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.
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 のような例を参考にしてください。
仕様書
Specification |
---|
Web Audio API # AudioDestinationNode |
ブラウザーの互換性
BCD tables only load in the browser