AudioContext

AudioContext インターフェースはAudioNodeとして表現されるオーディオモジュールから構成されるオーディオ処理グラフを表します。オーディオコンテキストはオーディオ処理やデコードを行うノードの作成を制御します。 Web Audioで何かする前に AudioContext を作成する必要があります。全てのできごとはコンテキストの中で起こるのです。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/AudioContext" target="_top"><rect x="151" y="1" width="120" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="211" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">AudioContext</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Constructor

AudioContext()

Creates and returns a new AudioContext object.

プロパティ

Also inherits properties from its parent interface, BaseAudioContext.

AudioContext.baseLatency 読取専用

Returns the number of seconds of processing latency incurred by the AudioContext passing the audio from the AudioDestinationNode to the audio subsystem.

AudioContext.outputLatency 読取専用

Returns an estimation of the output latency of the current audio context.

メソッド

BaseAudioContext インターフェースからのメソッドも実装しています。

AudioContext.close()

オーディオコンテキストを閉じて、使っていたシステムのオーディオリソースを全て解放します。

AudioContext.createMediaElementSource()

HTMLMediaElementに関連付けられたMediaElementAudioSourceNodeを生成します。これは<video>や<audio>要素の再生と編集で使います。

AudioContext.createMediaStreamSource()

MediaStreamで表された、ローカルコンピュータのマイクなどから来るオーディオストリームに関連付けられたMediaStreamAudioSourceNodeを生成します。

AudioContext.createMediaStreamDestination()

MediaStreamで表された、ローカルファイルや他のコンピュータから送られるオーディオストリームに関連付けられたMediaStreamAudioDestinationNodeを生成します

AudioContext.createMediaStreamTrackSource()

Creates a MediaStreamTrackAudioSourceNode associated with a MediaStream representing an media stream track.

AudioContext.getOutputTimestamp()

Returns a new AudioTimestamp object containing two correlated context's audio stream position values.

AudioContext.resume()

一時停止されたオーディオコンテキストの時間の流れを再開します。

AudioContext.suspend()

オーディオコンテキストの時間の流れを、一時的に音声ハードウェアへのアクセスとプロセスのCPU/バッテリーの使用を減らすことで一時停止します。

例

基本的なコンテキストの作成方法:

var audioCtx = new AudioContext();

クロスブラウザー対応版:

var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();

var oscillatorNode = audioCtx.createOscillator();
var gainNode = audioCtx.createGain();
var finish = audioCtx.destination;
// etc.

仕様

ブラウザーの互換性

参考

• Using the Web Audio API
• OfflineAudioContext