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 変数の間である必要があり、そうでなければ例外が発生します。

指定された AudioContextAudioDestinationNodeAudioContext.destination プロパティで取得できます。

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

プロパティ

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

AudioDestinationNode.maxChannelCount

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

メソッド

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

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

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

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

仕様書

Specification
Web Audio API
# AudioDestinationNode

ブラウザーの互換性

BCD tables only load in the browser

関連情報