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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AudioDestinationNode
maxChannelCount

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

関連情報