AudioContext
Baseline
広く利用可能
*
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
* この機能の一部は、対応レベルが異なる場合があります。
AudioContext インターフェイスは AudioNode によって表現され、互いにリンクする音声モジュールから作られた音声処理グラフを表します。
音声コンテキストは、それが格納するノードの作成と、音声処理（デコード）の実行の両方を制御します。何らかの処理を行う前に AudioContext を作成する必要があります。毎回新しいものを初期化するのではなく、 1 つの AudioContext を作成し、それを再利用することを推奨します。また、 1 つの AudioContext を複数の異なるオーディオソースに使用し、同時にパイプラインを使用しても問題ありません。
コンストラクター
AudioContext()-
AudioContextオブジェクトを新しく作成し、返します。
インスタンスプロパティ
親インターフェイスである BaseAudioContext から継承したプロパティもあります。
AudioContext.baseLatency読取専用-
AudioContextがAudioDestinationNodeから音声サブシステムに音声を渡す際に発生する処理遅延の秒数を返します。 AudioContext.outputLatency読取専用-
現在の音声コンテキストの出力レイテンシーの見積を返します。
AudioContext.sinkId読取専用-
現在の出力音声機器のシンク ID を返します。
インスタンスメソッド
親インターフェイスである BaseAudioContext から継承したメソッドもあります。
AudioContext.close()-
任意のシステム音声リソースをリリースするために、音声コンテキストを閉じます。
AudioContext.createMediaElementSource()-
HTMLMediaElementと関連付けられたMediaElementAudioSourceNodeを生成します。これは<video>要素もしくは<audio>要素からの再生や操作をするために使うことができます。 AudioContext.createMediaStreamSource()-
ローカルのコンピューターのマイクもしくは他のソースから来る音声ストリームを表現している
MediaStreamと関連付けられたMediaStreamAudioSourceNodeを生成します。 AudioContext.createMediaStreamDestination()-
ローカルファイルに保存されたものかその他のコンピューターに送信された音声ストリームを表す
MediaStreamと関連付けられたMediaStreamAudioDestinationNodeを生成します。 AudioContext.createMediaStreamTrackSource()-
メディアストリームトラックを表す
MediaStreamと関連づけられたMediaStreamTrackAudioSourceNodeを生成します。 AudioContext.getOutputTimestamp()-
2 つの関連づけられたコンテキストの音声ストリームの位置の値を含む新しい
AudioTimestampオブジェクトを返します。 AudioContext.resume()-
前回中断/一時停止した音声コンテキストの時間の進行を再開します。
AudioContext.setSinkId()-
この
AudioContext用の出力音声機器を設定します。 AudioContext.suspend()-
一時的に音声ハードウェアアクセスを停止し、プロセスの CPU/バッテリー使用を減らすために、音声コンテキストの時間の進行を中断します。
イベント
sinkchange-
出力音声デバイスが変更された (そしてその結果
AudioContext.sinkIdが変更された) 時発火します。
例
基本的な音声コンテキストの作成方法です。
const audioCtx = new AudioContext();
const oscillatorNode = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();
const finish = audioCtx.destination;
// etc.
仕様書
| 仕様書 |
|---|
| Web Audio API # AudioContext |