序文 原文

これまでの Web 上のオーディオはかなり未発達なもので、ごく最近まで Flash や QuickTime のようなプラグインを通して配信しなくてはなりませんでした。HTML5 での audio 要素の導入は、基本的なストリーミング・オーディオ再生を可能にする重要なものです。しかし、より複雑なオーディオアプリケーションを扱うには、それだけではまだ充分に強力ではありません。洗練された Web ベースのゲームやインタラクティブ・アプリケーションのためには別の解決策が必要とされます。この仕様では、近年のデスクトップ・オーディオ制作アプリケーションに見られるミキシング、プロセシング、フィルタリング処理に加え、近年のゲームオーディオエンジンに見られるような機能も持たせる事を目標とします。

この API はさまざまな使用例 [webaudio-usecases] を考慮して設計されています。理想的には すべての ユースケースがスクリプトから制御される最適化された C++ エンジンを使って無理なく実装でき、ブラウザーで動作するようにサポートされなくてはなりません。とは言っても、近年のデスクトップ・オーディオソフトウェアは極めて高度な機能を持ち、それらの一部はこのシステムを使ったとしても構築する事が困難か不可能と考えられます。Apple 社の Logic Audio がそのようなアプリケーションの 1 つであり、外部 MIDI コントローラー、任意のプラグイン・オーディオエフェクトやシンセサイザー、高度に最適化されたオーディオファイルのディスクへの読み込み/書き出し、密に統合されたタイムストレッチなどなどをサポートしています。それでもなお、ここで提案するシステムは、音楽に関するものを含めて、かなり複雑なゲームやインタラクティブ・アプリケーションの広い範囲を充分にサポートする事が可能です。またそれは、WebGL によってもたらされる、より高度なグラフィックスの機能をよく引き立たせる事が可能です。このAPIはより高度な機能を後から追加できるように設計されています。

機能 原文

この API は、これらの基本機能をサポートします:

• 単純な、あるいは複雑なミキシング/エフェクト・アーキテクチャーのための モジュラールーティング

• 内部処理に 32 ビット浮動小数を使用した高いダイナミックレンジ

• 非常に高度なリズムの精度を必要とするドラムマシンやシーケンサーなどのアプリケーションのための、低 レイテンシー な サンプル単位の時間精度での音の再生。これには、エフェクトを 動的に生成 できるようにする事も含まれます

• エンベロープ、フェードイン/フェードアウト、グラニュラーエフェクト、フィルタースイープ、LFO などのためのオーディオパラメーターのオートメーション

• 分割や結合など、オーディオストリームのチャンネルに対する柔軟な扱い

• audio または video メディア要素 からのオーディオに対する処理

• getUserMedia() からの MediaStream を使用したライブオーディオ入力に対する処理

• WebRTC との統合

  • MediaStreamTrackAudioSourceNode と [webrtc] を使ってリモート・ピアから受け取ったオーディオの処理

  • 生成または加工されたオーディオストリームの MediaStreamAudioDestinationNode と [webrtc] を使ったリモート・ピアへの送信

• スクリプトでの直接的 なオーディオストリームの合成および加工

• 3D ゲームや没入環境を幅広くサポートする 空間音響 :

  • パンニングモデル: 等価パワー, HRTF, パススルー

  • 距離減衰

  • サウンドコーン

  • 障害物 / 遮蔽物

  • 音源 / リスナー

• 広範囲の線形エフェクト、特に非常に高い品質のルーム・エフェクトに使用できるコンボリューションエンジン。これによって可能なエフェクトの例を以下に示します:

  • 小さい / 大きい部屋

  • 大聖堂

  • コンサートホール

  • 洞窟

  • トンネル

  • 廊下

  • 森

  • 野外劇場

  • ドア越しの遠くの部屋

  • 極端なフィルター

  • 風変りな巻き戻し効果

  • 極端なコムフィルター効果

• ミックス全体の制御やスウィートニング ( 訳注:ビデオに効果音などをつける MA 作業 ) のためのダイナミック・コンプレッション

• 効率的な リアルタイムの時間領域および周波数領域解析 / ミュージックビジュアライザーのサポート

• 効率的な双二次フィルターによる、ローパス、ハイパス、その他一般的なフィルター

• ディストーションやその他の非線形エフェクトのためのウェーブシェイピング・エフェクト

• オシレーター

モジュラールーティング 原文

モジュラールーティングによって異なる AudioNode オブジェクト同士を任意に接続できます。それぞれのノードは 入力 および 出力 を持っています。 ソースノード は入力は持たず、ひとつの出力を持ちます。 デスティネーションノード はひとつの入力を持ち、出力は持っていません。フィルターなどの他のノードはソースとデスティネーションの間に配置することができます。2 つのオブジェクトが互いに接続し場合、低レベルのストリーム形式の詳細について開発者が煩わされる事なく、適正な処理が行われます。 例えばもしモノラルの音声ストリームがステレオの入力に接続されていても、左右のチャンネルに 適正 にミックスされます。

最も単純な例は、ひとつの音声ソースを出力に直接接続したものです。すべての接続は単一の AudioDestinationNode を持つ AudioContext 内部で行われます:

この単純なルーティングを図示します。この例では単一の音を再生しています:

const context = new AudioContext();
 
 function playSound() {
   const source = context.createBufferSource();
   source.buffer = dogBarkingBuffer;
   source.connect(context.destination);
   source.start(0);
 }
 

これはもっと複雑な例で、3 つのソースとコンボリューションリバーブが最終出力段にあるダイナミックコンプレッサーを介して送られます:

let context;let compressor;let reverb;let source1, source2, source3;let lowpassFilter;let waveShaper;let panner;let dry1, dry2, dry3;let wet1, wet2, wet3;let mainDry;let mainWet;function setupRoutingGraph () {  context = new AudioContext();  // Create the effects nodes.  lowpassFilter = context.createBiquadFilter();  waveShaper = context.createWaveShaper();  panner = context.createPanner();  compressor = context.createDynamicsCompressor();  reverb = context.createConvolver();  // Create main wet and dry.  mainDry = context.createGain();  mainWet = context.createGain();  // Connect final compressor to final destination.  compressor.connect(context.destination);  // Connect main dry and wet to compressor.  mainDry.connect(compressor);  mainWet.connect(compressor);  // Connect reverb to main wet.  reverb.connect(mainWet);  // Create a few sources.  source1 = context.createBufferSource();  source2 = context.createBufferSource();  source3 = context.createOscillator();  source1.buffer = manTalkingBuffer;  source2.buffer = footstepsBuffer;  source3.frequency.value = 440;  // Connect source1  dry1 = context.createGain();  wet1 = context.createGain();  source1.connect(lowpassFilter);  lowpassFilter.connect(dry1);  lowpassFilter.connect(wet1);  dry1.connect(mainDry);  wet1.connect(reverb);  // Connect source2  dry2 = context.createGain();  wet2 = context.createGain();  source2.connect(waveShaper);  waveShaper.connect(dry2);  waveShaper.connect(wet2);  dry2.connect(mainDry);  wet2.connect(reverb);  // Connect source3  dry3 = context.createGain();  wet3 = context.createGain();  source3.connect(panner);  panner.connect(dry3);  panner.connect(wet3);  dry3.connect(mainDry);  wet3.connect(reverb);  // Start the sources now.  source1.start(0);  source2.start(0);  source3.start(0);}

モジュラールーティングはまた AudioNode の出力を 別の AudioNode の動きを制御する AudioParam パラメーターに接続する事もできます。この場合は、ノードからの出力は 入力信号ではなくモジュレーション信号として働きます。

function setupRoutingGraph() {  const context = new AudioContext();  // Create the low frequency oscillator that supplies the modulation signal  const lfo = context.createOscillator();  lfo.frequency.value = 1.0;  // Create the high frequency oscillator to be modulated  const hfo = context.createOscillator();  hfo.frequency.value = 440.0;  // Create a gain node whose gain determines the amplitude of the modulation signal  const modulationGain = context.createGain();  modulationGain.gain.value = 50;  // Configure the graph and start the oscillators  lfo.connect(modulationGain);  modulationGain.connect(hfo.detune);  hfo.connect(context.destination);  hfo.start(0);  lfo.start(0);}

API の概要 原文

定義されているインターフェースは次のとおりです:

• AudioContext インターフェースは、AudioNode 間の接続を表すオーディオ信号グラフを保持します。

• AudioNode インターフェースは、オーディオのソース、オーディオの出力、その間にある処理モジュールを表します。AudioNode は モジュラー方式 で動的に互いに接続されます。AudioNode は AudioContext のコンテキスト内に存在します。

• AnalyserNode インターフェースは、ミュージックビジュアライザーやその他の視覚化アプリケーションで使用される AudioNode です。

• AudioBuffer インターフェースは、メモリー内に保持されるオーディオのリソースで使用されます。これらはワンショットの音、またはもっと長いオーディオクリップを表します。

• AudioBufferSourceNode インターフェースは、AudioBuffer からの音を発生する AudioNode です。

• AudioDestinationNode インターフェースは、AudioNode のサブクラスでオーディオの最終的な出力地点を表します。

• AudioParam インターフェースは、AudioNode の個別の機能、例えば音量などを制御します。

• AudioListener インターフェースは、PannerNode と共に空間音響のために使用されます。

• AudioWorklet インターフェースは、スクリプトでオーディオを直接処理するカスタムノードを作成するファクトリーを表します。

• AudioWorkletGlobalScope インターフェースは、AudioWorkletProcessor の処理スクリプトが実行されるコンテキストです。

• AudioWorkletNode インターフェースは、AudioWorkletProcessor で処理される AudioNode を表します。

• AudioWorkletProcessor インターフェースは、Audio ワーカー内の 1 つのノードのインスタンスを表します。

• BiquadFilterNode インターフェースは、次のような一般的な低次のフィルターの AudioNode です:

  • ローパス

  • ハイパス

  • バンドパス

  • ローシェルフ

  • ハイシェルフ

  • ピーキング

  • ノッチ

  • オールパス

• ChannelMergerNode インターフェースは、複数のオーディオストリームからひとつのオーディオストリームにチャンネルの結合を行う AudioNode です。

• ChannelSplitterNode インターフェースは、ルーティンググラフ内のオーディオストリームの個別のチャンネルにアクセスするために使用される AudioNode です。

• ConstantSourceNode インターフェースは、AudioParam による値のオートメーションが可能な定数値を出力する AudioNode です。

• ConvolverNode インターフェースは、( 例えばコンサートホールでの音のような ) リアルタイム線形エフェクトを加える AudioNode です。

• DelayNode インターフェースは、動的に調整可能な遅延を行う AudioNode です。

• DynamicsCompressorNode インターフェースは、ダイナミクス・コンプレッションのための AudioNode です。

• GainNode インターフェースは、明示的なゲイン制御を行う AudioNode です。

• IIRFilterNode インターフェースは、一般的な IIR フィルターの AudioNode です。

• MediaElementAudioSourceNode インターフェースは、audio、video その他のメディア要素を音源とする AudioNode です。

• MediaStreamAudioSourceNode インターフェースは、ライブオーディオ入力やリモート・ピアから受け取ったような MediaStream を音源とする AudioNode です。

• MediaStreamTrackAudioSourceNode インターフェースは、 MediaStreamTrack からのオーディオを音源とする AudioNode です。

• MediaStreamAudioDestinationNode インターフェースは、リモート・ピアに送信する MediaStream を出力先とする AudioNode です。

• PannerNode インターフェースは、3D 空間での空間音響/空間定位のための AudioNode です。

• PeriodicWave インターフェースは、OscillatorNode で使用されるカスタム周期波形を指定するために使用されます。

• OscillatorNode インターフェースは、周期的な波形を発生する AudioNode です。

• StereoPannerNode インターフェースは、ステレオストリームで 入力された信号の equal-power 方式の定位を行う AudioNode です。

• WaveShaperNode インターフェースは、ディストーションやその他微妙なウォーミング効果 ( 訳注:いわゆるサチュレーション効果の事 ) など、非線形のウェーブシェイピング・エフェクトを加えるための AudioNode です。

また、Web Audio API で既に非推奨とされましたがまだ削除されておらず、置き換えの実装が予定されているいくつかの機能があります。

• ScriptProcessorNode インターフェースは、スクリプトでオーディオを直接生成または処理するための AudioNode です。

• AudioProcessingEvent インターフェースは、ScriptProcessorNode オブジェクトと共に用いられるイベントタイプです。

1. オーディオ API 原文

1.1. BaseAudioContext インターフェース 原文

このインターフェースは AudioNode オブジェクトのセットとそれらの接続を表します。それによって AudioDestinationNode に任意の信号をルーティングする事を可能にします。ノードはコンテキストから作成され、お互いに 接続 されます。

BaseAudioContext は直接的にはインスタンス化されず、代わりに AudioContext (リアルタイムレンダリングの場合)と OfflineAudioContext (オフラインレンダリングの場合)が拡張された具体的なインターフェースとなっています。

BaseAudioContext は、初期状態では空のプロミスの順序付きリストである [[pending promises]] という内部スロットによって作成されます。

enum AudioContextState {
   "suspended",
   "running",
   "closed"
 };
 

callback DecodeErrorCallback = undefined (DOMException error);
 
 callback DecodeSuccessCallback = undefined (AudioBuffer decodedData);
 
 [Exposed=Window]
 interface BaseAudioContext : EventTarget {
   readonly attribute AudioDestinationNode destination;
   readonly attribute float sampleRate;
   readonly attribute double currentTime;
   readonly attribute AudioListener listener;
   readonly attribute AudioContextState state;
   [SameObject, SecureContext]
   readonly attribute AudioWorklet audioWorklet;
   attribute EventHandler onstatechange;
 
   AnalyserNode createAnalyser ();
   BiquadFilterNode createBiquadFilter ();
   AudioBuffer createBuffer (unsigned long numberOfChannels,
                             unsigned long length,
                             float sampleRate);
   AudioBufferSourceNode createBufferSource ();
   ChannelMergerNode createChannelMerger (optional unsigned long numberOfInputs = 6);
   ChannelSplitterNode createChannelSplitter (
     optional unsigned long numberOfOutputs = 6);
   ConstantSourceNode createConstantSource ();
   ConvolverNode createConvolver ();
   DelayNode createDelay (optional double maxDelayTime = 1.0);
   DynamicsCompressorNode createDynamicsCompressor ();
   GainNode createGain ();
   IIRFilterNode createIIRFilter (sequence<double> feedforward,
                                  sequence<double> feedback);
   OscillatorNode createOscillator ();
   PannerNode createPanner ();
   PeriodicWave createPeriodicWave (sequence<float> real,
                                    sequence<float> imag,
                                    optional PeriodicWaveConstraints constraints = {});
   ScriptProcessorNode createScriptProcessor(
     optional unsigned long bufferSize = 0,
     optional unsigned long numberOfInputChannels = 2,
     optional unsigned long numberOfOutputChannels = 2);
   StereoPannerNode createStereoPanner ();
   WaveShaperNode createWaveShaper ();
 
   Promise<AudioBuffer> decodeAudioData (
     ArrayBuffer audioData,
     optional DecodeSuccessCallback? successCallback,
     optional DecodeErrorCallback? errorCallback);
 };
 

1.1.1. 属性 原文

MDN

BaseAudioContext/audioWorklet

Firefox76+SafariNoneChrome66+

---

OperaYesEdge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android79+iOS SafariNoneChrome for Android66+Android WebView66+Samsung Internet9.0+Opera MobileYes

audioWorklet, AudioWorklet 型, readonly

[HTML] と AudioWorklet のアルゴリズムにより定義された AudioWorkletProcessor クラスのスクリプトをインポート可能な Worklet オブジェクトへのアクセスを行います。

MDN

BaseAudioContext/currentTime

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

currentTime, double 型, readonly

コンテキストのレンダリンググラフで最後に処理されたオーディオブロックの最後のサンプルフレームの次のサンプルフレームを秒で表した時刻です。もしコンテキストのレンダリンググラフがまだオーディオブロックを処理していない場合 currentTime は 0 になります。

currentTime の時間軸で 0 はグラフで処理される最初のブロックの最初のサンプルフレームに対応します。このシステムの経過時間は BaseAudioContext が生成するオーディオストリームの経過時間に対応し、それはシステム内の他の時計には同期しないかも知れません。( OfflineAudioContext では、ストリームはどのデバイスでも能動的に再生されないため、実時間とはまったく違う進み方になります )

Web Audio API のすべてのスケジュールされた時刻は currentTime に対する相対値になります。

BaseAudioContext が "running" 状態にあるとき、この属性の値は単調増加し、レンダリングスレッドにより 1 レンダリング量子 に対応する均一な増分で更新されます。そのため動作中のコンテキストでは、currentTime はシステムがオーディオブロックを処理するに従って徐々に増加し、常に次に処理されるオーディオブロックの先頭の時刻を表します。それはまた現在の状態に対する変更が効力を持つ最も早い時刻でもあります。

currentTime は制御スレッドが処理を戻すまでに アトミック に読み取られなくてはなりません ( MUST )。

MDN

BaseAudioContext/destination

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

destination, AudioDestinationNode 型, readonly

AudioDestinationNode は単一の入力を持ち、すべてのオーディオの最終的な出口を表しています。通常これは実際のオーディオハードウェアを表します。動作中のすべての AudioNode は直接または間接的にこの destination に接続されます。

MDN

BaseAudioContext/listener

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

listener, AudioListener 型, readonly

AudioListener は 3D 空間音響 で使用されます。

MDN

BaseAudioContext/onstatechange

Firefox53+SafariNoneChrome43+

---

OperaYesEdge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android53+iOS SafariNoneChrome for AndroidYesAndroid WebViewYesSamsung InternetYesOpera MobileYes

onstatechange, EventHandler 型

BaseAudioContext に AudioContext の状態が変化したとき ( 例えば、対応する Promise がリゾルブされたときなど ) にディスパッチされるイベントの EventHandler を設定するために使用されるプロパティです。 AudioContext の状態を直接問い合わせる事ができる Event 型のイベントがイベントハンドラーに発行されます。 新たに作成された AudioContextは 常に suspended 状態から開始し、状態の変化イベントは異なる状態への遷移の度に発行されます。このイベントは oncomplete イベントが発行される前に発行されます。

MDN

BaseAudioContext/sampleRate

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

sampleRate, float 型, readonly

BaseAudioContext が扱うオーディオのサンプルレート ( 1 秒あたりのサンプルフレーム数 ) です。コンテキスト内のすべての AudioNode はこのレートで動作する事を想定しています。これを想定するため、サンプレートコンバータや " 可変速 " 処理はリアルタイム処理内ではサポートされません。 ナイキスト周波数 はこのサンプルレートの半分の値となります。

MDN

BaseAudioContext/state

Firefox53+SafariNoneChrome43+

---

OperaYesEdge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android53+iOS SafariNoneChrome for AndroidYesAndroid WebViewYesSamsung InternetYesOpera MobileYes

state, AudioContextState 型, readonly

AudioContext の現在の状態を表します。その値は 制御スレッドの状態 と同じです。

1.1.2. メソッド 原文

MDN

BaseAudioContext/createAnalyser

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createAnalyser()

AnalyserNode の ファクトリーメソッド です。

パラメーターなし

戻り値: AnalyserNode

MDN

BaseAudioContext/createBiquadFilter

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createBiquadFilter()

いくつかの一般的なフィルタータイプに設定可能な 2 次フィルターを表す BiquadFilterNode の ファクトリーメソッド です。

パラメーターなし

戻り値: BiquadFilterNode

MDN

BaseAudioContext/createBuffer

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createBuffer(numberOfChannels, length, sampleRate)

与えられたサイズの AudioBuffer を作成します。バッファ内のデータは 0 ( 無音 ) で初期化されます。もし、引数のどれかが負、0 または範囲外の場合、NotSupportedError 例外を発生します ( MUST )。

BaseAudioContext.createBuffer() メソッドの引数。

パラメーター	型	Null可	省略可	説明
numberOfChannels	unsigned long	✘	✘	バッファが持つチャンネル数を指定します。実装は少なくとも 32 チャンネルをサポートしなくてはなりません ( MUST )。
length	unsigned long	✘	✘	バッファのサイズをサンプルフレーム数で指定します。これは少なくとも1でなくてはなりません ( MUST )。
sampleRate	float	✘	✘	バッファ内の リニア PCM オーディオデータのサンプルレートを秒あたりのサンプルフレーム数で表します。実装は少なくとも 8000 から 96000 の範囲をサポートしなくてはなりません ( MUST )。

戻り値: AudioBuffer

MDN

BaseAudioContext/createBufferSource

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createBufferSource()

AudioBufferSourceNode の ファクトリーメソッド です。

パラメーターなし

戻り値: AudioBufferSourceNode

MDN

BaseAudioContext/createChannelMerger

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createChannelMerger(numberOfInputs)

チャンネルマージャーを表す ChannelMergerNode の ファクトリーメソッド です。numberOfInputs が 1 より小さいかサポートされる数より大きい場合は IndexSizeError 例外を発生します ( MUST )。

BaseAudioContext.createChannelMerger(numberOfInputs) メソッドの引数。

パラメーター	型	Null可	省略可	説明
numberOfInputs	unsigned long	✘	✔	入力の数を指定します。値は 32 までサポートされなくてはなりません ( MUST )。もし指定されない場合は 6 となります。

戻り値: ChannelMergerNode

MDN

BaseAudioContext/createChannelSplitter

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createChannelSplitter(numberOfOutputs)

チャンネルスプリッターを表す ChannelSplitterNode の ファクトリーメソッド です。numberOfOutputs が 1 より小さいかサポートされる数より大きい場合は、IndexSizeError 例外を発生します ( MUST )。

BaseAudioContext.createChannelSplitter(numberOfOutputs) メソッドの引数

パラメーター	型	Null可	省略可	説明
numberOfOutputs	unsigned long	✘	✔	出力の数を指定します。値は 32 までサポートされなくてはなりません ( MUST )。もし指定されない場合は 6 となります。

戻り値: ChannelSplitterNode

MDN

BaseAudioContext/createConstantSource

Firefox53+SafariNoneChrome56+

---

Opera43+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android53+iOS SafariNoneChrome for Android56+Android WebView56+Samsung Internet6.0+Opera Mobile43+

createConstantSource()

ConstantSourceNode の ファクトリーメソッド です。

パラメーターなし

戻り値: ConstantSourceNode

MDN

BaseAudioContext/createConvolver

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createConvolver()

ConvolverNode の ファクトリーメソッド です。

パラメーターなし

戻り値: ConvolverNode

MDN

BaseAudioContext/createDelay

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createDelay(maxDelayTime)

DelayNode の ファクトリーメソッド です。初期化時のデフォルト遅延時間は 0 秒です。

BaseAudioContext.createDelay(maxDelayTime) メソッドの引数

パラメーター	型	Null可	省略可	説明
maxDelayTime	double	✘	✔	遅延機能の遅延時間の最大値を秒で指定します。指定する場合は、その値は 0 よりも大きく 3 分よりも小さくなければなりません ( MUST )。そうでない場合 NotSupportedError 例外を発生します ( MUST )。 指定しない場合は 1 となります。

戻り値: DelayNode

MDN

BaseAudioContext/createDynamicsCompressor

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createDynamicsCompressor()

DynamicsCompressorNode の ファクトリーメソッド です。

パラメーターなし

戻り値: DynamicsCompressorNode

MDN

BaseAudioContext/createGain

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createGain()

GainNode の ファクトリーメソッド です。

パラメーターなし

戻り値: GainNode

MDN

BaseAudioContext/createIIRFilter

Firefox53+SafariNoneChrome49+

---

OperaYesEdge79+

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android49+Android WebView49+Samsung Internet5.0+Opera MobileYes

createIIRFilter(feedforward, feedback)

BaseAudioContext.createIIRFilter() メソッドの引数

パラメーター	型	Null可	省略可	説明
feedforward	sequence<double>	✘	✘	IIR フィルターの伝達関数のフィードフォワード ( 分子 ) の係数の配列です。この配列の最大の長さは 20 です。もしすべての値が 0 の場合、InvalidStateError 例外を発生します ( MUST )。 配列の長さが 0 または 20 より大きい場合は NotSupportedError 例外を発生します ( MUST )。
feedback	sequence<double>	✘	✘	IIR フィルターの伝達関数のフィードバック ( 分母 ) の係数の配列です。この配列の最大の長さは20です。もし配列の最初の要素が 0 の場合、InvalidStateError 例外を発生します ( MUST )。 もし配列の長さが 0 または 20 より大きい場合は NotSupportedError 例外を発生します ( MUST )。

戻り値: IIRFilterNode

MDN

BaseAudioContext/createOscillator

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createOscillator()

OscillatorNode の ファクトリーメソッド です。

パラメーターなし

戻り値: OscillatorNode

MDN

BaseAudioContext/createPanner

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createPanner()

PannerNode の ファクトリーメソッド です。

パラメーターなし

戻り値: PannerNode

MDN

BaseAudioContext/createPeriodicWave

Firefox53+SafariNoneChrome59+

---

Opera22+Edge79+

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android59+Android WebView59+Samsung Internet7.0+Opera Mobile22+

createPeriodicWave(real, imag, constraints)

PeriodicWave を作成する ファクトリーメソッド です。

このメソッドを呼び出したとき、以下の手順が実行されます:

1. もし real と imag が同じ長さでない場合、IndexSizeError が発生します ( MUST )。

2. o を PeriodicWaveOptions 型の新しいオブジェクトとします。

3. このファクトリーメソッドに各々渡された real および imag パラメーターを、o の同じ名前の属性として設定します。

4. o の disableNormalization 属性を、ファクトリーメソッドに渡された constraints 属性の disableNormalization の値に設定します。

5. このファクトリーメソッドが呼ばれた BaseAudioContext を最初の引数とし、o を渡して新しい PeriodicWave p を作成します。

6. p を返します。

BaseAudioContext.createPeriodicWave() メソッドの引数

パラメーター	型	Null可	省略可	説明
real	sequence<float>	✘	✘	コサインパラメーターの数値列です。詳細の説明についてはコンストラクタの引数 real を参照してください。
imag	sequence<float>	✘	✘	サインパラメーターの数値列です。詳細の説明についてはコンストラクタの引数 imag を参照してください。
constraints	PeriodicWaveConstraints	✘	✔	指定されていない場合は、波形は正規化されます。そうでない場合、波形は constraints に与えられた値に従って正規化されます。

戻り値: PeriodicWave

MDN

BaseAudioContext/createScriptProcessor

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels)

ScriptProcessorNode の ファクトリーメソッド です。このメソッドは廃止予定 ( DEPRECATED ) で、AudioWorkletNode で置き換えられます。 スクリプトによるオーディオデータ直接処理のための ScriptProcessorNode を作成します。 bufferSize または numberOfInputChannels または numberOfOutputChannels が範囲外の場合、 IndexSizeError 例外を発生します ( MUST )。

numberOfInputChannels と numberOfOutputChannels の両方を 0 にはできません。この場合、IndexSizeError 例外を発生します ( MUST )。

BaseAudioContext.createScriptProcessor(bufferSize, numberOfInputChannels, numberOfOutputChannels) メソッドの引数

パラメーター	型	Null可	省略可	説明
bufferSize	unsigned long	✘	✔	bufferSize パラメーターはサンプルフレーム数でバッファのサイズを指定します。もしそれが渡されない場合、または値が 0 である場合、実装はノードのライフタイムを通して一定な、動作環境に最適な2の累乗のバッファサイズを選択します。それ以外の場合は明示的にバッファサイズを指定します。それは次の値のどれかでなければなりません: 256、512、1024、2048、4096、8192、16384 ( MUST )。この値は onaudioprocess イベントが発生する頻度とそれぞれの呼び出しでどれだけのサンプルフレームを処理する必要があるかを制御します。bufferSize が小さい値ならば レイテンシー は低く ( 良く ) なります。オーディオが途切れ、グリッジ が発生する事を避けるには大きな値が必要となります。レイテンシー とオーディオ品質の間のバランスを取るためには、プログラマーはこのバッファサイズを指定せず、実装に最適なバッファサイズを選択させる事が推奨されます。もしこのパラメーターの値が上に示した許された2の累乗の値でない場合、IndexSizeError 例外を発生します ( MUST )。
numberOfInputChannels	unsigned long	✘	✔	このパラメーターはこのノードの入力チャンネル数を指定します。デフォルトの値は 2 です。32 チャンネルまでの値がサポートされなくてはなりません。チャンネル数がサポート外の場合、NotSupportedError 例外を発生します。
numberOfOutputChannels	unsigned long	✘	✔	このパラメーターはこのノードの出力チャンネル数を指定します。デフォルトの値は 2 です。32 チャンネルまでの値がサポートされなくてはなりません。チャンネル数がサポート外の場合、NotSupportedError 例外を発生します。

戻り値: ScriptProcessorNode

MDN

BaseAudioContext/createStereoPanner

Firefox53+SafariNoneChrome42+

---

OperaNoneEdge79+

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for AndroidYesAndroid WebViewYesSamsung InternetYesOpera MobileNone

createStereoPanner()

StereoPannerNode の ファクトリーメソッド です。

パラメーターなし

戻り値: StereoPannerNode

MDN

BaseAudioContext/createWaveShaper

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

createWaveShaper()

非線形な歪み効果を表す WaveShaperNode の ファクトリーメソッド です。

パラメーターなし

戻り値: WaveShaperNode

MDN

BaseAudioContext/decodeAudioData

Firefox53+SafariNoneChromeNone

---

Opera22+EdgeNone

---

Edge (Legacy)18IENone

---

Firefox for Android53+iOS SafariNoneChrome for Android33+Android WebViewYesSamsung Internet2.0+Opera Mobile22+

decodeAudioData(audioData, successCallback, errorCallback)

ArrayBuffer 内にあるオーディオファイルのデータを非同期にデコードします。ArrayBuffer は、例えば XMLHttpRequest で responseType に "arraybuffer" を指定した場合の response 属性としてロードされます。オーディオファイルデータは audio 要素でサポートされるどのフォーマットでも構いません。decodeAudioData() に渡されるバッファは [mimesniff] で説明される手順で判定されるコンテントタイプを持ちます。

この関数の基本的なインターフェースの手段は戻り値の promise ではありますが、歴史的な理由からコールバックのパラメーターも提供されています。

decodeAudioData が呼ばれたとき、制御スレッド上では次の手順を実行します ( MUST ):

1. thisに対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 "InvalidStateError" DOMException でpromise をリジェクト して返します。

2. promise を新しい Promise とします。

3. もし audioData に対する、IsDetachedBuffer ([ECMASCRIPT] で説明されています) が false の場合、次の手順を実行します:

   1. promise を [[pending promises]] に追加します。

   2. audioData ArrayBuffer を Detach します。この操作は [ECMASCRIPT] で説明されています。もしこの操作に失敗した場合はステップ 3 にジャンプします。

   3. 別のスレッドで実行されるデコード処理をキューにいれます。

4. そうでなければ、次の手順を実行します:

   1. error を DataCloneError とします。

   2. promise を error でリジェクトし、[[pending promises]] から削除します。

   3. errorCallback を error で呼び出す タスクをキューに入れます 。

5. promise を返します。

制御スレッド でも レンダリングスレッド でもない、デコーディングスレッド と呼ばれる別のスレッドで実行されるデコード処理がキューに入れられるとき、次の手順が発生します ( MUST )。

Note: 複数回の decodeAudioData の呼び出しを処理するため、複数の デコーディングスレッド が並列して走る事もあります。

1. can decode を初期状態が true のブーリアンフラグとします。

2. MIME Sniffing §6.2 Matching an audio or video type pattern を用いて、audioData の MIME タイプの決定を試みます。もしオーディオまたはビデオのパターンマッチングアルゴリズムが undefined を返した場合 can decode を false に設定します。

3. もし can decode が true の場合、エンコードされている audioData を リニア PCM にデコードを試みます。もし失敗した場合は can decode を false に設定します。

4. もし can decode が false の場合、 制御スレッド のイベントループで次のステップを実行するための タスクをキューに入れます :

   1. error を EncodingError という名前の DOMException とします。

      2. promise を error でリジェクトし、 [[pending promises]] から削除します。

   2. もし errorCallback が存在している場合は errorCallback を error で呼び出します。

5. そうでなければ:

   1. デコードされたリニア PCM の結果を得て、AudioContext のサンプルレートが audioData のサンプルレートと異なっていたらリサンプルを行います。

   2. 制御スレッド のイベントループで次のステップを実行するための タスクをキューに入れます:

      1. buffer を最終的な結果 ( 必要ならサンプルレート変換を行った後 ) を保持した AudioBuffer とします。

      2. promise を buffer を持ってリゾルブします。

      3. もし successCallback が存在していれば successCallback を buffer を持って呼び出します。

BaseAudioContext.decodeAudioData() メソッドの引数

パラメーター	型	Null可	省略可	説明
audioData	ArrayBuffer	✘	✘	圧縮されたオーディオデータを含む ArrayBuffer です。
successCallback	DecodeSuccessCallback?	✔	✔	デコードが完了したときに呼び出されるコールバック関数です。コールバック関数の引数は 1 つでデコードされた PCM オーディオデータをあらわす AudioBuffer になります。
errorCallback	DecodeErrorCallback?	✔	✔	オーディオファイルをデコード中にエラーが起こった場合に呼び出されるコールバック関数です。

戻り値: Promise<AudioBuffer>

1.1.3. コールバック DecodeSuccessCallback() パラメーター 原文

decodedData, AudioBuffer　型

デコードしたオーディオデータを保持する AudioBuffer。

1.1.4. コールバック DecodeErrorCallback() パラメーター 原文

error, DOMException 型

デコード中に発生したエラー。

1.1.5. ライフタイム 原文

AudioContext は一度作成された後、これ以上再生する音がなくなるまで、あるいはページを移動するまで再生を続けます。

1.1.6. 内部検査やシリアライゼーションの基本機能の欠如 原文

Web Audio API は音源のスケジューリングに fire-and-forget アプローチを取っています。つまり、音源ノード は、 AudioContext のライフタイムの間のひとつひとつの音に対応して作成され、明示的にグラフからの削除は行いません。これはシリアライゼーション API とは互換性がなく、そのためシリアライズ可能な固定的なノードのセットもありません。

さらに、内部検査のための API を持つためにはスクリプトの中身のガベージコレクションの監視が必要になります。

1.1.7. BaseAudioContext サブクラスに関連付けられるシステムリソース 原文

サブクラス、 AudioContext と OfflineAudioContext はコストの高いオブジェクトと考えるべきです。これらのオブジェクトの作成には、高プライオリティのスレッドまたは低レイテンシーのシステムオーディオを含み、どちらも消費電力への影響があります。通常は、1 つのドキュメント内に 1 つ以上の AudioContext を作成する事は不必要です。

BaseAudioContext のサブクラスの作成または再開は、そのコンテキストが システムリソースを取得 する事を含みます。このためには AudioContext としてはシステムオーディオのストリームを作成する事も必要です。これらの動作はコンテキストが関連するオーディオグラフから出力の生成を開始する際に処理を戻します。

なお、ユーザーエージェントは実装で定められた最大数の AudioContext を持つ事ができ、それ以上の新しい AudioContext の作成は失敗して、 NotSupportedError 例外を発生します。

プログラマーは suspend および close を使う事で、スレッド、プロセスおよびオーディオストリームを含む システムリソースの解放 を行う事ができます。BaseAudioContext をサスペンドする事で、実装は一部のリソースを解放して後で resume. を呼び出したときに再開できるようにします。 AudioContext のクローズによって、実装はすべてのリソースを解放し、再度使用したり再開したりはできなくなります。

注 : これは例えば、定期的なコールバックの呼び出しを待つ事やハードウェアが処理可能になるのを待つ事も含みます。

1.2. AudioContext インターフェース 原文

このインターフェースは、その AudioDestinationNode がデバイスへのリアルタイム出力によって直接ユーザーに信号が届くオーディオグラフを表します。多くの場合、１ つのドキュメントにつき 1 つの AudioContext が使用されます。

enum AudioContextLatencyCategory {
     "balanced",
     "interactive",
     "playback"
 };
 

[Exposed=Window]
 interface AudioContext : BaseAudioContext {
   constructor (optional AudioContextOptions contextOptions = {});
   readonly attribute double baseLatency;
   readonly attribute double outputLatency;
   AudioTimestamp getOutputTimestamp ();
   Promise<undefined> resume ();
   Promise<undefined> suspend ();
   Promise<undefined> close ();
   MediaElementAudioSourceNode createMediaElementSource (HTMLMediaElement mediaElement);
   MediaStreamAudioSourceNode createMediaStreamSource (MediaStream mediaStream);
   MediaStreamTrackAudioSourceNode createMediaStreamTrackSource (
     MediaStreamTrack mediaStreamTrack);
   MediaStreamAudioDestinationNode createMediaStreamDestination ();
 };
 

ユーザーエージェントがコンテキストの状態を "suspended"から "running"に移行できる場合、 AudioContext が スタート可能 であると言います。 ユーザーエージェントは、 AudioContext の 関連するグローバルオブジェクト が スティッキーアクティベーション を持っている場合にのみ許可するために、この初期遷移を遅延させることができます。

AudioContext は内部にスロットを持っている :

[[suspended by user]]

コンテキストがユーザーのコードによって中断されているかどうかを表すブーリアンフラグ。 初期値は false です。

1.2.1. コンストラクター 原文

MDN

AudioContext/AudioContext

Firefox25+SafariNoneChrome35+

---

Opera22+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS SafariNoneChrome for Android35+Android WebView37+Samsung Internet3.0+Opera Mobile22+

AudioContext(contextOptions)

現在の設定オブジェクト の 対応するドキュメント が 完全にアクティブ でない場合は InvalidStateError を発生して、次の手順を中止します。

AudioContext を作成する際は、以下の手順を実行します:

1. AudioContext 上の 制御スレッドの状態 を suspended に設定します。

2. AudioContext 上の レンダリングスレッドの状態 を suspended に設定します。

3. [[pending resume promises]] をこの AudioContext 上のスロットとし、初期状態を空の promise のリストとします。

4. もし contextOptions が与えられていれば、オプションを適用します:

   1. この AudioContext の内部レイテンシーを latencyHint の項に書かれているように、 contextOptions.latencyHint に従って設定します。

   2. もし contextOptions.sampleRate が指定されていれば、この AudioContext の sampleRate をその値に設定します。 そうでなければ、デフォルト出力デバイスのサンプルレートを使用します。 もし選択されたサンプルレートが出力デバイスのサンプルレートと異なる場合、この AudioContext はオーディオ出力を出力デバイスのサンプルレートに合うようにリサンプリングしなくてはなりません ( MUST )。

      注 : もしリサンプリングが必要とされる場合、AudioContext のレイテンシーに大きな影響があるかも知れません。

5. もし AudioContext が スタート可能 ならば、処理を開始するための 制御メッセージ を送ります。

6. この AudioContext オブジェクトを返します。

処理を開始するための 制御メッセージ を送るには次の手順を実行します:

1. システムリソースの取得 を試みます。もし失敗した場合は以降の手順を中止します。

2. AudioContext の レンダリングスレッドの状態 を running on the AudioContext に設定します。

3. 制御スレッド のイベントループで以下の手順を実行するための タスクをキューに入れます :

   1. AudioContext の state 属性を "running" に設定します。

   2. AudioContext に statechange という名前のシンプルイベントを発行するための タスクをキューに入れます。

注 : 残念ながら、AudioContext の作成の失敗についてプログラム上の通知をすることはできません。ユーザーエージェントは、デベロッパーツールコンソールのようなログメカニズムにアクセスできる場合、これを知らせるメッセージをログに記録することをお勧めします。

AudioContext.constructor(contextOptions) メソッドの引数

パラメーター	型	Null可	省略可	説明
contextOptions	AudioContextOptions	✘	✔	AudioContext をどのように作成するかをユーザーが指定するオプション。

1.2.2. 属性 原文

MDN

AudioContext/baseLatency

Firefox70+SafariNoneChrome58+

---

Opera45+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android58+Android WebView58+Samsung Internet7.0+Opera Mobile43+

baseLatency, double　型, readonly

これは AudioContext が AudioDestinationNode からオーディオサブシステムにオーディオを渡す処理で発生するレイテンシーの秒数を表します。これには AudioDestinationNode の出力とオーディオハードウェアの間で発生するかも知れないその他の処理による追加のレイテンシーは含まれず、特にオーディオグラフ自体に発生するレイテンシーは含まれません。

例えばもし、オーディオコンテキストが 44.1 kHz で動作しており、 AudioDestinationNode の実装が内部でダブルバッファリングによる レンダリング量子 の出力処理を行う場合、処理のレイテンシーは、約 \((2\cdot128)/44100 = 5.805 \mathrm{ ms}\) となります。

⚠MDN

AudioContext/outputLatency

In only one current engine.

Firefox70+SafariNoneChromeNone

---

OperaNoneEdgeNone

---

Edge (Legacy)NoneIENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for AndroidNoneAndroid WebViewNoneSamsung InternetNoneOpera MobileNone

outputLatency, double 型, readonly

オーディオ出力処理のレイテンシーの秒数の見積もり。つまり、UA がホストシステムにバッファを再生を要求した時間から、バッファ内の最初のサンプルが実際にオーディオ出力デバイスで処理される時間までの間隔。この後者の時間は、スピーカーやヘッドフォンのような音の信号を発生するデバイスがサンプルの音を発生する時間を指します。

outputLatency 属性の値はプラットフォームと接続されているオーディオ出力デバイスに依存します。outputLatency 属性の値は接続されているオーディオ出力デバイスが同じである限り、コンテキストのライフタイムを通じて変化する事はありません。もしオーディオ出力デバイスが変化したならば、outputLatency 属性の値もそれに従ってアップデートされます。

1.2.3. メソッド 原文

✔MDN

AudioContext/close

In all current engines.

Firefox40+SafariYesChrome42+

---

OperaYesEdge79+

---

Edge (Legacy)14+IENone

---

Firefox for Android40+iOS SafariYesChrome for Android43+Android WebView43+Samsung Internet4.0+Opera MobileYes

close()

AudioContext をクローズし、使用中の システムリソースを解放 します。これは、 AudioContext が作成したすべてのオブジェクトを自動的に開放はしませんが、 AudioContext の currentTime の進行を止め、オーディオデータの処理を停止します。

close が呼ばれたとき、以下の手順が実行されます:

1. this に 対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 "InvalidStateError" DOMException で promise をリジェクト して返します。

2. promise を新しい Promise とします。

3. もし AudioContext の 制御スレッドの状態 フラグが closed であった場合、promise を InvalidStateError でリジェクトし、これらの手順を中断して promise を返します。

4. AudioContext の 制御スレッドの状態 フラグを closed に設定します。

5. AudioContext をクローズするための 制御メッセージをキューに入れます。

6. promise を返します。

AudioContext をクローズするための 制御メッセージ を実行する事は、 レンダリングスレッド で、以下の手順を実行する事を意味します:

1. システムリソースの解放 を試みます。

2. レンダリングスレッドの状態 を suspended に設定します。

   これによりレンダリングは停止します。

3. もしこの 制御メッセージ がドキュメントがアンロードされる反応の途中で実行されているなら、このアルゴリズムを中止します。

   この場合、制御スレッドへの通知は必要ありません。

4. 制御スレッド のイベントループで以下の手順を実行する タスクをキューに入れます :

   1. promise をリゾルブします。

   2. もし AudioContext の state 属性が既に "closed" でない場合:

      1. AudioContext の state 属性を "closed" に設定します。

      2. AudioContext で statechange という名前のシンプルイベントを発行するための タスクをキューに入れます。

AudioContext がクローズされた場合、 AudioContext に接続されているすべての MediaStream と HTMLMediaElement はその出力を無視されます。 つまり、これらはもうスピーカーなどの出力デバイスに出力されなくなります。より柔軟な挙動のためには、 HTMLMediaElement.captureStream() の使用を検討してください。

注 : AudioContext がクローズされるとき、実装はサスペンドの場合よりも積極的に多くのリソースを解放する事ができます。

パラメーターなし

戻り値: Promise<undefined>

✔MDN

AudioContext/createMediaElementSource

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS SafariYesChrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

createMediaElementSource(mediaElement)

指定された HTMLMediaElement から MediaElementAudioSourceNode を作成します。 このメソッドの呼び出しにより、 HTMLMediaElement からのオーディオの再生は AudioContext の処理グラフに再ルーティングされるようになります。

AudioContext.createMediaElementSource() メソッドの引数

パラメーター	型	Null可	省略可	説明
mediaElement	HTMLMediaElement	✘	✘	再ルーティングされるメディアエレメントです。

戻り値: MediaElementAudioSourceNode

✔MDN

AudioContext/createMediaStreamDestination

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android26+iOS SafariYesChrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

createMediaStreamDestination()

MediaStreamAudioDestinationNode を作成します。

パラメーターなし

戻り値: MediaStreamAudioDestinationNode

✔MDN

AudioContext/createMediaStreamSource

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS SafariYesChrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

createMediaStreamSource(mediaStream)

MediaStreamAudioSourceNode を作成します。

AudioContext.createMediaStreamSource() メソッドの引数

パラメーター	型	Null可	省略可	説明
mediaStream	MediaStream	✘	✘	音源となるメディアストリームです。

戻り値: MediaStreamAudioSourceNode

⚠MDN

AudioContext/createMediaStreamTrackSource

In only one current engine.

Firefox68+SafariNoneChromeNone

---

OperaNoneEdgeNone

---

Edge (Legacy)NoneIENone

---

Firefox for Android68+iOS SafariNoneChrome for AndroidNoneAndroid WebViewNoneSamsung InternetNoneOpera MobileNone

createMediaStreamTrackSource(mediaStreamTrack)

MediaStreamTrackAudioSourceNode を作成します。

AudioContext.createMediaStreamTrackSource() メソッドの引数

パラメーター	型	Null可	省略可	説明
mediaStreamTrack	MediaStreamTrack	✘	✘	音源となる MediaStreamTrack です。 その kind 属性は ""audio"" でなくてはならず、そうでない場合は、InvalidStateError 例外を発生します ( MUST )。

戻り値: MediaStreamTrackAudioSourceNode

MDN

AudioContext/getOutputTimestamp

Firefox70+SafariNoneChrome57+

---

Opera44+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android57+Android WebView57+Samsung Internet7.0+Opera Mobile43+

getOutputTimestamp()

コンテキストのオーディオストリームについて、2 つの関連する位置情報を含む新しい AudioTimestamp インスタンスを返します: contextTime メンバーには、オーディオ出力デバイスによって現在レンダリングされているサンプルフレームの時間 ( つまり出力されているオーディオストリームの位置 ) が含まれます。これにはコンテキストの currentTime と同じ単位と起点を使用します。 そして performanceTime メンバーには、contextTime に格納された値に対応するサンプルフレームが performance.now() ( [hr-time-2] で説明されています ) と同じ単位および起点で、オーディオ出力デバイスによってレンダリングされる瞬間を推定する時間が含まれます 。

コンテキストのレンダリンググラフがまだオーディオブロックを処理していないときに getOutputTimestamp を呼び出すと、両方のメンバーが 0 である AudioTimestamp インスタンスを返します。

コンテキストのレンダリンググラフがオーディオブロックの処理を開始すると、その currentTime 属性の値は常に getOutputTimestamp メソッドの呼び出しで取得される contextTime 値より大きくなります。

getOutputTimestamp メソッドから返された値は、コンテキストの時刻のわずかに後になるパフォーマンスの時刻の見積もりを得るのに使用できます:

function outputPerformanceTime(contextTime) {
   const timestamp = context.getOutputTimestamp();
   const elapsedTime = contextTime - timestamp.contextTime;
   return timestamp.performanceTime + elapsedTime * 1000;
 }
 

上の例での見積もりの精度は、引数の値が現在の出力オーディオストリームの位置にどれほど近いかによって決まります: つまり与えられた contextTime が timestamp.contextTime に近いほど、得られた推定の精度は良くなります。

注 : コンテキストの currentTime と getOutputTimestamp メソッドの呼び出しから得られた contextTime の値の差は、 currentTime が不均一な時間間隔で増加する可能性があるため、信頼できる出力レイテンシーの見積もりとみなす事はできず、代わりに outputLatency 属性を使用する必要があります。

パラメーターなし

戻り値: AudioTimestamp

✔MDN

AudioContext/resume

In all current engines.

Firefox40+SafariYesChrome41+

---

OperaYesEdge79+

---

Edge (Legacy)14+IENone

---

Firefox for AndroidYesiOS SafariYesChrome for Android41+Android WebViewYesSamsung Internet4.0+Opera MobileYes

resume()

AudioContext の currentTime の進行が停止している場合、再開させます。

resume が呼ばれた時、以下のステップが実行されます :

1. this に 対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 "InvalidStateError" DOMException で リジェクト して promise を返します。

2. promise を新しい Promise とします。

3. もし AudioContext の 制御スレッドの状態 が closed であれば promise は InvalidStateError でリジェクトされ、これらのステップは中止して promise を返します。

4. [[suspended by user]] を false に設定します。

5. もしこのコンテキストが スタート可能 でない場合 promise を [[pending promises]] と [[pending resume promises]] に加え、これらのステップを中止して promise を返します。

6. AudioContext の 制御スレッドの状態 を running に設定します。

7. AudioContext を再開するための 制御メッセージをキューに入れます。

8. promise を返します。

AudioContext を再開するための 制御メッセージ を実行するとは、次のステップを レンダリングスレッド で実行する事を意味します:

1. システムリソースの取得 を試みます。

2. AudioContext の レンダリングスレッドの状態 を running に設定します。

3. オーディオグラフのレンダリング を開始します。

4. 失敗した場合は 制御スレッド で以下を実行してこれらのステップを中止します :

   1. [[pending resume promises]] から全ての promise を順番にリジェクトして [[pending resume promises]] を空にします。

   2. さらに、これらの promise を [[pending promises]] から削除します。

5. 制御スレッド のイベントループ上でこれらのステップを実行するためのタスクをキューに入れます :

   1. [[pending resume promises]] にある promise を順番にリゾルブします。

   2. [[pending resume promises]]を空にします。さらに、これらの promise を [[pending promises]] から削除します。

   3. promise をリゾルブします。

   4. もし AudioContext の state 属性が既に "running" でない場合 :

      1. AudioContext の state 属性を "running" に設定します。

      2. AudioContext で statechange という名前のシンプルイベントを発行するためのタスクをキューに入れます。

パラメーターなし

戻り値: Promise<undefined>

✔MDN

AudioContext/suspend

In all current engines.

Firefox40+SafariYesChrome43+

---

OperaYesEdge79+

---

Edge (Legacy)14+IENone

---

Firefox for Android40+iOS SafariYesChrome for Android43+Android WebView43+Samsung Internet4.0+Opera MobileYes

suspend()

AudioContext の currentTime の進行を中断し、デスティネーションで再生するために既に処理を終えた現在のコンテキストの処理ブロックを再生し、その後システムがオーディオハードウェアの占有を解放できるようにします。 これは一般的に、アプリケーションがしばらくの間 AudioContext を必要とせず、一時的に AudioContext に関連付けられた システムリソースを解放 したいことがアプリケーションに分かっているときに役に立ちます。この promise は、フレームバッファが空のとき ( ハードウェアに渡されたとき )、またはコンテキストがすでに suspended 状態のときは即座に ( 副作用なしで ) リゾルブされます。コンテキストがクローズされた場合、promise はリジェクトされます。

suspend が呼び出された場合、以下の手順を実行します:

1. this に 対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 "InvalidStateError" DOMException で リジェクト して promise を返します。

2. promise を新しい Promise とします。

3. もし AudioContext の 制御スレッドの状態 が closed であれば promise は InvalidStateError でリジェクトされ、これらのステップは中止して promise を返します。

4. promise を [[pending promises]] に追加します。

5. [[suspended by user]] を true に設定します。

6. AudioContext の 制御スレッドの状態 を suspended に設定します。

7. AudioContext をサスペンドするための 制御メッセージをキューに入れます。

8. promise を返します。

AudioContext をサスペンドするための 制御メッセージ を実行する、とは レンダリングスレッド で、以下の手順を実行する事を意味します:

1. システムリソースの解放 を試みます。

2. AudioContext の レンダリングスレッドの状態 を suspended に設定します。

3. 制御スレッド のイベントループで以下の手順を実行する タスクをキューに入れます:

   1. promise をリゾルブします。

   2. もし AudioContext の state 属性が既に "suspended" でない場合:

      1. AudioContext の state 属性を "suspended" に設定します。

      2. AudioContext で statechange という名前のシンプルイベントを発行する タスクをキューに入れます。

AudioContext がサスペンドされている間 MediaStream の出力は無視されます。つまり、メディアストリームのリアルタイム性によって、データは失われます。HTMLMediaElement も同様に、システムが再開されるまでその出力は無視されます。AudioWorkletNode および ScriptProcessorNode は、サスペンド中は処理ハンドラーの呼び出しが止まりますが、コンテキストがリジュームされると再開します。AnalyserNode では、ウィンドウ関数の目的そのものにより、データは連続ストリームとみなされます。つまり、resume()/suspend() によって AnalyserNode のデータストリームに無音は発生しません。特に、AudioContext がサスペンドされているときに AnalyserNode の関数を繰り返し呼び出した際は、同じデータが返されなければなりません ( MUST )。

パラメーターなし

戻り値: Promise<undefined>

1.2.4. AudioContextOptions 原文

AudioContextOptions ディクショナリーは AudioContext のユーザー指定のオプションを決めるために使用されます。

dictionary AudioContextOptions {
   (AudioContextLatencyCategory or double) latencyHint = "interactive";
   float sampleRate;
 };
 

1.2.4.1. ディクショナリー AudioContextOptions メンバー 原文

MDN

AudioContextOptions/latencyHint

Firefox61+Safari?Chrome60+

---

Opera?Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android61+iOS Safari?Chrome for Android60+Android WebView60+Samsung Internet8.0+Opera Mobile?

latencyHint, (AudioContextLatencyCategory or double) 型, デフォルト値は "interactive"

オーディオ出力のレイテンシーと消費電力の間のトレードオフに影響を与える、再生のタイプを指示します。

latencyHint の値は、 AudioContextLatencyCategory から選択する事が推奨されます。ただし、レイテンシーと消費電力をより細かくバランスを取るために、レイテンシーの秒数を double 型で指定することもできます。数値を適切に解釈するのはブラウザーの裁量に委ねられています。実際に使用されるレイテンシーは、 AudioContext の baseLatency 属性によって与えられます。

MDN

AudioContextOptions/sampleRate

Firefox61+Safari?Chrome74+

---

OperaNoneEdge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android61+iOS Safari?Chrome for Android74+Android WebView74+Samsung Internet11.0+Opera Mobile?

sampleRate, float 型

作成される AudioContext の sampleRate をこの値に設定します。サポートされている値は AudioBuffer のサンプルレートと同じです。指定されたサンプルレートがサポートされていない場合は NotSupportedError 例外を発生します ( MUST )。

もし sampleRate が指定されていない場合、この AudioContext の出力デバイスが推奨するサンプルレートが使用されます。

1.2.5. AudioTimestamp 原文

dictionary AudioTimestamp {
   double contextTime;
   DOMHighResTimeStamp performanceTime;
 };
 

1.2.5.1. ディクショナリー AudioTimestamp メンバー 原文

contextTime, double 型

BaseAudioContext の currentTime の時間軸内の時刻を表します。

performanceTime, DOMHighResTimeStamp 型

Performance インターフェースの実装における時間軸内の時刻を表します ( [hr-time-2] で説明されています )。

1.3. OfflineAudioContext インターフェース 原文

OfflineAudioContext は、レンダリング/ミックスダウンのための特殊なタイプの BaseAudioContext で、( 潜在的には ) リアルタイムよりも高速に動作します。これはオーディオハードウェアに対してレンダリングせず、可能な限り高速にレンダリングした結果を AudioBuffer に格納して promise を返します。

[Exposed=Window]
 interface OfflineAudioContext : BaseAudioContext {
   constructor(OfflineAudioContextOptions contextOptions);
   constructor(unsigned long numberOfChannels, unsigned long length, float sampleRate);
   Promise<AudioBuffer> startRendering();
   Promise<undefined> resume();
   Promise<undefined> suspend(double suspendTime);
   readonly attribute unsigned long length;
   attribute EventHandler oncomplete;
 };
 

1.3.1. コンストラクター 原文

MDN

OfflineAudioContext/OfflineAudioContext

Firefox53+Safari?Chrome55+

---

Opera42+Edge79+

---

Edge (Legacy)NoneIENone

---

Firefox for Android53+iOS Safari?Chrome for Android55+Android WebView55+Samsung Internet6.0+Opera Mobile42+

OfflineAudioContext(contextOptions)

現在の設定オブジェクト に 対応するドキュメント が 完全にアクティブ でない場合は、 InvalidStateError を発生して、これらの手順を中止します。

c を新しい OfflineAudioContext オブジェクトとします。 c を次のように初期化します:

1. c の 制御スレッド の状態 を ""suspended"" とします。

2. c の レンダリングスレッドの状態 を ""suspended"" とします。

3. channelCount を contextOptions.numberOfChannels とした AudioDestinationNode を作成します。

OfflineAudioContext.constructor(contextOptions) メソッドの引数

パラメーター	型	Null可	省略可	説明
contextOptions				このコンテキストを作成する際に必要な初期化パラメーター

OfflineAudioContext(numberOfChannels, length, sampleRate)

OfflineAudioContext は AudioContext.createBuffer と同じ引数で作成できます。もし引数のどれかが負、0、または範囲外の場合は NotSupportedError 例外を発生します ( MUST )。

OfflineAudioContext は、次の呼び出し

new OfflineAudioContext({
     numberOfChannels: numberOfChannels,
     length: length,
     sampleRate: sampleRate
 })
 

が行われたのと同じように作成されます。

OfflineAudioContext.constructor(numberOfChannels, length, sampleRate) メソッドの引数

パラメーター	型	Null可	省略可	説明
numberOfChannels	unsigned long	✘	✘	バッファが持つチャンネルの数を指定します。サポートされているチャンネル数については、 createBuffer() を参照してください。
length	unsigned long	✘	✘	バッファのサイズをサンプルフレーム数で指定します。
sampleRate	float	✘	✘	バッファ内の リニア PCM オーディオデータのサンプルレートをサンプルフレーム / 秒で記述します。有効なサンプルレートについては、createBuffer() を参照してください。

1.3.2. 属性 原文

MDN

OfflineAudioContext/length

FirefoxYesSafariNoneChrome51+

---

Opera38+Edge79+

---

Edge (Legacy)14+IENone

---

Firefox for AndroidYesiOS SafariNoneChrome for Android51+Android WebView51+Samsung Internet5.0+Opera Mobile41+

length, unsigned long 型, readonly

サンプルフレーム数で表したバッファのサイズです。これは、コンストラクタの length パラメーターの値と同じです。

✔MDN

OfflineAudioContext/oncomplete

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari?Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

oncomplete, EventHandler 型

OfflineAudioCompletionEvent 型の EventHandler です。これは OfflineAudioContext で最後に発行されるイベントです。

1.3.3. メソッド 原文

✔MDN

OfflineAudioContext/startRendering

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari?Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

startRendering()

与えられた現在の接続と変化のスケジュールで、オーディオのレンダリングを開始します。

レンダリングされたオーディオデータを取得する主な方法は、promise の戻り値を経由する方法ですが、インスタンスは歴史的な理由により、 complete という名前のイベントも発生させます。

[[rendering started]] をこの OfflineAudioContext の内部スロットとします。 このスロットは false に初期化されます。

startRendering が呼び出されたとき、制御スレッド で次の手順を実行しなくてはなりません ( MUST ) :

1. this に 対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 InvalidStateError DOMException で promise をリジェクト して返します。
2. OfflineAudioContext の [[rendering started]] スロットが true の場合、InvalidStateError でリジェクトした promise を返し、これらの手順を中止します。
3. OfflineAudioContext の [[rendering started]] スロットを true に設定します。
4. promise を新しい Promise とします。
5. contextOptions パラメーターでこのインスタンスのコンストラクタに渡された numberOfChannels、length、および sampleRate の値にそれぞれ等しいチャンネル数、長さ、およびサンプルレートを持つ、新しい AudioBuffer を作成します。このバッファを OfflineAudioContext の内部スロット [[rendered buffer]] に割り当てます。
6. 前項の AudioBuffer コンストラクタ呼び出し中に例外が発生した場合、この例外を持って promise をリジェクトします。
7. そうでなく、バッファが正常に作成された場合は、オフラインレンダリングを開始 します。
8. promise を [[pending promises]] に追加します。
9. promise を返します。

オフラインレンダリングを開始 するには、その際に作成された レンダリングスレッド で次の手順が実行されなくてはなりません ( MUST )。

1. 現在の接続と変化のスケジュールが与えられたら、length 長のオーディオのサンプルフレームを [[rendered buffer]] にレンダリングし始めます。
2. レンダリング量子 ごとにチェックを行い、必要ならば suspend します。
3. もしサスペンドされていたコンテキストが再開された場合、バッファへのレンダリングを継続します。
4. レンダリングが完了したら、制御スレッド のイベントループで次の手順を実行する タスクをキューに入れます:
   1. startRendering() によって作成された promise を [[rendered buffer]] をもってリゾルブします。
   2. OfflineAudioCompletionEvent のインスタンスの renderedBuffer プロパティに [[rendered buffer]] を設定し、 complete という名前のイベントを発行する タスクをキューに入れます。

パラメーターなし

戻り値: Promise<AudioBuffer>

⚠MDN

OfflineAudioContext/resume

In only one current engine.

FirefoxNoneSafariNoneChrome49+

---

Opera36+Edge79+

---

Edge (Legacy)18IENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android49+Android WebView49+Samsung Internet5.0+Opera Mobile36+

resume()

OfflineAudioContext がサスペンドされていた場合、その currentTime の進行を再開します。

resumte が呼び出された場合これらのステップを実行します:

1. this に 対応するグローバルオブジェクト に 関連付けられたドキュメント が 完全にアクティブ でない場合は、 InvalidStateError DOMException で promise をリジェクト して返します。

2. promise を新しい Promise とします。

3. 次の条件が真となった場合、これらのステップを中止し promise を InvalidStateError でリジェクトします :

   • OfflineAudioContext の 制御スレッドの状態 が closed になった。

   • OfflineAudioContext の [[rendering started]] スロットが false になった。

4. OfflineAudioContext の 制御スレッドの状態 フラグを running に設定します。

5. OfflineAudioContext を再開させるための 制御メッセージをキューに入れます。

6. promise を返します。

OfflineAudioContext を再開する 制御メッセージ を実行するとは、これらのステップを レンダリングスレッド で実行する事を意味します :

1. OfflineAudioContext の 制御スレッドの状態 を running に設定します。

2. オーディオグラフのレンダリング を開始します。

3. 失敗した場合は 制御スレッド で promise をリジェクトするタスクをキューに入れ、これらのステップを中止します :

4. 制御スレッド のイベントループで、これらのステップを実行するタスクをキューに入れます :

   1. promise をリゾルブします。

   2. もし OfflineAudioContext の state 属性が既に "running" でない場合 :

      1. OfflineAudioContext の state 属性を "running" に設定します。

      2. OfflineAudioContext 上で statechange という名前のシンプルイベントを発行するためのタスクをキューに入れます。

パラメーターなし

戻り値: Promise<undefined>

⚠MDN

OfflineAudioContext/suspend

In only one current engine.

FirefoxNoneSafariNoneChrome49+

---

Opera36+Edge79+

---

Edge (Legacy)18IENone

---

Firefox for AndroidNoneiOS SafariNoneChrome for Android49+Android WebView49+Samsung Internet5.0+Opera Mobile36+

suspend(suspendTime)

指定された時刻にオーディオコンテキストの時間進行の停止をスケジュールし、promise を返します。これは一般的に、 OfflineAudioContext でオーディオグラフを同期して操作する場合に有用です。

サスペンドの最大の精度は レンダリング量子 のサイズであり、指定されたサスペンドの時刻は最も近い レンダリング量子 の境界に丸められることに注意してください。このため、同じ量子化されたフレーム内で複数のサスペンドをスケジュールすることはできません。また精度の高いサスペンドを確実に行うには、コンテキストが動作中でない間にスケジューリングを行う必要があります。

OfflineAudioContext.suspend() メソッドの引数

パラメーター	型	Null可	省略可	説明
suspendTime	double	✘	✘	指定された時刻にレンダリングのサスペンドをスケジューリングします。時刻は レンダリング量子 のサイズで量子化されて丸められます。 量子化されたフレーム番号が 負の値、または 現在の時刻より小さいか同じ、または レンダリング全体の長さより大きいか同じ、または 同じ時刻に別のサスペンドがスケジュールされている の場合、promise は InvalidStateError でリジェクトされます。

戻り値: Promise<undefined>

1.3.4. OfflineAudioContextOptions 原文

これは OfflineAudioContext の作成の際に使用するオプションを指定します。

dictionary OfflineAudioContextOptions {
   unsigned long numberOfChannels = 1;
   required unsigned long length;
   required float sampleRate;
 };
 

1.3.4.1. ディクショナリー OfflineAudioContextOptions メンバー 原文

length, unsigned long 型

サンプルフレーム数で表したレンダリングされる AudioBuffer の長さ。

numberOfChannels, unsigned long 型, デフォルトは 1

この OfflineAudioContext のチャンネル数。

sampleRate, float 型

この OfflineAudioContext のサンプルレート。

1.3.5. OfflineAudioCompletionEvent インターフェース 原文

これは、歴史的な理由から OfflineAudioContext に発行される Event オブジェクトです。

[Exposed=Window]
 interface OfflineAudioCompletionEvent : Event {
   constructor (DOMString type, OfflineAudioCompletionEventInit eventInitDict);
   readonly attribute AudioBuffer renderedBuffer;
 };
 

1.3.5.1. 属性 原文

✔MDN

OfflineAudioCompletionEvent/renderedBuffer

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS SafariYesChrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

renderedBuffer, AudioBuffer 型, readonly

レンダリングしたオーディオデータを保持する AudioBuffer です。

1.3.5.2. OfflineAudioCompletionEventInit 原文

dictionary OfflineAudioCompletionEventInit : EventInit {
   required AudioBuffer renderedBuffer;
 };
 

1.3.5.2.1. ディクショナリー OfflineAudioCompletionEventInit メンバー 原文

renderedBuffer, AudioBuffer 型

イベントの renderedBuffer 属性に割り当てる値。

1.4. AudioBuffer インターフェース 原文

このインターフェースは、メモリー上にあるオーディオデータを表します。そのフォーマットはノンインタリーブな 32 ビットの浮動小数点の リニア PCM で、通常は \([-1,1]\) の範囲になりますが、値はこの範囲に限定はされません。通常、PCM データの長さはかなり短く ( 通常は 1 分未満 ) と想定されています。音楽サウンドトラックなどのより長いサウンドの場合、audio 要素と MediaElementAudioSourceNode によるストリーミングを使うべきです。

AudioBuffer は、1 つ以上の AudioContext によって使用され、OfflineAudioContext と AudioContext の間で共有する事もできます。

AudioBuffer には 4 つの内部スロットがあります：

[[number of channels]]

この AudioBuffer のオーディオチャンネルの数、符号なし long 型です。

[[length]]

この AudioBuffer の各チャンネルの長さ、符号なし long 型です。

[[sample rate]]

Hz で表した AudioBuffer のサンプルレート、float 型です。

[[internal data]]

オーディオのサンプルデータを保持する データブロック です。

[Exposed=Window]
 interface AudioBuffer {
   constructor (AudioBufferOptions options);
   readonly attribute float sampleRate;
   readonly attribute unsigned long length;
   readonly attribute double duration;
   readonly attribute unsigned long numberOfChannels;
   Float32Array getChannelData (unsigned long channel);
   undefined copyFromChannel (Float32Array destination,
                              unsigned long channelNumber,
                              optional unsigned long bufferOffset = 0);
   undefined copyToChannel (Float32Array source,
                            unsigned long channelNumber,
                            optional unsigned long bufferOffset = 0);
 };
 

1.4.1. コンストラクター 原文

AudioBuffer(options)

1. options の値のいずれかが公称範囲外にある場合は、NotSupportedError 例外を発生し、以下の手順を中止します。

2. b を新しい AudioBuffer オブジェクトとします。

3. コンストラクタで渡された AudioBufferOptions の属性 numberOfChannels、length、sampleRate の値をそれぞれ内部スロット [[number of channels]]、[[length]]、[[sample rate]] に割り当てます。

4. この AudioBuffer の内部スロット [[internal data]] を CreateByteDataBlock([[length]] * [[number of channels]]) を呼び出した結果に設定します。

   注 : これは、下層にある記憶域をゼロに初期化します。

5. b を返します。

AudioBuffer.constructor() メソッドの引数

パラメーター	型	Null可	省略可	説明
options	AudioBufferOptions	✘	✘	AudioBufferOptions はこの AudioBuffer のプロパティを決定します。

1.4.2. 属性 原文

✔MDN

AudioBuffer/duration

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari6+Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

duration, double 型, readonly

PCM オーディオデータの長さで、単位は秒です。

これは [[sample rate]] と AudioBuffer の [[length]] から計算され、[[length]] を [[sample rate]] で割る事で求められます。

✔MDN

AudioBuffer/length

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari6+Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

length, unsigned long 型, readonly

サンプルフレーム数で表した PCM オーディオデータの長さです。これは [[length]] の値を返さなければなりません ( MUST )。

✔MDN

AudioBuffer/numberOfChannels

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari6+Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

numberOfChannels, unsigned long 型, readonly

個別のオーディオチャンネルの数です。これは [[number of channels]] の値を返さなければなりません ( MUST )。

✔MDN

AudioBuffer/sampleRate

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari6+Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

sampleRate, float 型, readonly

サンプル / 秒で表した PCM オーディオデータのサンプルレートです。これは、[[sample rate]] の値を返さなければなりません ( MUST )。

1.4.3. メソッド 原文

MDN

AudioBuffer/copyFromChannel

Firefox25+SafariNoneChrome43+

---

Opera30+Edge79+

---

Edge (Legacy)13+IENone

---

Firefox for Android26+iOS SafariNoneChrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile30+

copyFromChannel(destination, channelNumber, bufferOffset)

copyFromChannel() メソッドは、 AudioBuffer の指定されたチャンネルからサンプルを destination の配列にコピーします。

buffer を \(N_b\) フレームの AudioBuffer とし、\(N_f\) を destination 配列の要素数とし、\(k\) を bufferOffset の値とします。このとき、 buffer から destination にコピーされるフレームの数は \(\max(0, \min(N_b - k, N_f))\) となります。もしこれが \(N_f\) より小さい場合、 destination の残りの要素は変更されません。

AudioBuffer.copyFromChannel() メソッドの引数

パラメーター	型	Null可	省略可	説明
destination	Float32Array	✘	✘	チャンネルデータがコピーされる配列です。
channelNumber	unsigned long	✘	✘	データをコピーするチャンネルのインデックスです。 channelNumber が AudioBuffer のチャンネル数と同じか大きい場合、IndexSizeError 例外を発生します ( MUST )。
bufferOffset	unsigned long	✘	✔	オプションのオフセットで、デフォルトは 0 です。 AudioBuffer のこのオフセットから始まるデータが destination にコピーされます。

戻り値: undefined

MDN

AudioBuffer/copyToChannel

Firefox25+SafariNoneChrome43+

---

Opera30+Edge79+

---

Edge (Legacy)13+IENone

---

Firefox for Android26+iOS SafariNoneChrome for Android43+Android WebView43+Samsung Internet4.0+Opera Mobile30+

copyToChannel(source, channelNumber, bufferOffset)

copyToChannel() メソッドは、 source 配列から AudioBuffer の指定されたチャンネルにサンプルをコピーします。

もし、 source がバッファにコピーできない場合は UnknownError を発生する事があります。

buffer を \(N_b\) フレームの AudioBuffer とし \(N_f\) を source 配列の要素数とし、\(k\) を bufferOffset の値とします。このとき、 source から buffer にコピーされるフレームの数は \(\max(0, \min(N_b - k, N_f))\) となります。これが \(N_f\) より小さい場合、 buffer の残りの要素は変更されません。

AudioBuffer.copyToChannel() メソッドの引数

パラメーター	型	Null可	省略可	説明
source	Float32Array	✘	✘	チャンネルデータがコピーされる元の配列です。
channelNumber	unsigned long	✘	✘	データをコピーする先のチャンネルのインデックスです。もし channelNumber が AudioBuffer のチャンネル数より大きいか同じ場合、IndexSizeError を発生します ( MUST )。
bufferOffset	unsigned long	✘	✔	データをコピーする先を示すオプションのオフセットで、デフォルトは 0 です。 source からのデータが AudioBuffer のこのオフセットから始まる場所にコピーされます。

戻り値: undefined

✔MDN

AudioBuffer/getChannelData

In all current engines.

Firefox25+Safari6+Chrome14+

---

Opera15+Edge79+

---

Edge (Legacy)12+IENone

---

Firefox for Android26+iOS Safari6+Chrome for Android18+Android WebViewYesSamsung Internet1.0+Opera Mobile14+

getChannelData(channel)

コンテンツの取得 で説明されているルールに従って、新しい Float32Array の [[internal data]] に格納されているバイトの 参照を取得 または バイトの コピーを取得 します。

もし、 [[internal data]] (訳注: の読み出し) または新しい Float32Array の作成ができなかった場合は、 UnknownError を発生する事があります。

AudioBuffer.getChannelData() メソッドの引数

パラメーター	型	Null可	省略可	説明
channel	unsigned long	✘	✘	このパラメーターは、データを取得する特定のチャンネルを表すインデックスです。インデックス値 0 は最初のチャンネルを表します。このインデックス値は [[number of channels]] より小さくなくてはならず ( MUST )、そうでない場合は IndexSizeError 例外を発生します ( MUST )。

戻り値: Float32Array

注 : copyToChannel() と copyFromChannel() メソッドはより大きな配列のビューである Float32Array を渡す事で配列の一部だけを埋めるのに使用できます。 AudioBuffer のチャンネルからデータを読み取ってまとめて処理する場合、不要なメモリの割り当てとコピーを回避するため、 getChannelData() を呼び出して結果の配列にアクセスするよりも、 copyFromChannel() をお勧めします。

APIの実装が AudioBuffer の内容が必要になったとき、 AudioBuffer の内容の取得 という内部処理が起動されます。この処理は呼び出し元に変更不能なチャンネルデータを返します。

AudioBuffer の内容の取得 処理は、次の場合に呼び出されます:

• AudioBufferSourceNode.start が呼び出されると、ノードの buffer の 内容の取得 を行います。この処理が失敗した場合は何も再生されません。

• AudioBufferSourceNode.start があらかじめ呼び出されている状態で、 AudioBufferSourceNode の buffer が設定されたとき、その設定処理が AudioBuffer の 内容の取得 を行います。この処理が失敗した場合、何も再生されません。

• ConvolverNode の buffer がある AudioBuffer に設定されたとき AudioBuffer の 内容の取得 が行われます。

• AudioProcessingEvent のディスパッチが完了すると、その outputBuffer の 内容の取得 が行われます。

注 : これは copyToChannel() は現在 AudioNode が AudioBuffer の内容を取得 して使用中の AudioBuffer の内容を変更するためには使えない事を意味します。 AudioNode は以前に取得したデータを使い続けます。

1.4.4. AudioBufferOptions 原文

これは AudioBuffer の作成に使用するオプションを指定します。 length と sampleRate メンバーは必須です。

dictionary AudioBufferOptions {
   unsigned long numberOfChannels = 1;
   required unsigned long length;
   required float sampleRate;
 };
 

1.4.4.1. ディクショナリー AudioBufferOptions メンバー 原文

このディクショナリーのメンバーが取れる値には制約があります。 createBuffer() を参照してください。

length, unsigned long 型

サンプルフレーム数で表されるバッファの長さです。制約については length を参照してください。

numberOfChannels, unsigned long 型, デフォルド値は 1

バッファのチャンネル数です。制約については numberOfChannels を参照してください。

sampleRate, float 型

Hz で表されるバッファのサンプルレートです。制約については sampleRate を参照してください。

1.5. AudioNode インターフェース 原文

AudioNode は AudioContext を構成するブロックです。このインターフェースは、音源、音の出力先、および中間の処理モジュールを表しています。これらのモジュールは互いに接続されて、音をオーディオハードウェアに出力するための 処理グラフ を形成します。それぞれのノードは 入力 や 出力 を持つ事ができます。 ソースノード は入力を持たず、単一の出力を持ちます。フィルターのようなほとんどの処理ノードは、1 つの入力と 1 つの出力を持ちます。それぞれのタイプの AudioNode はどのようにオーディオを処理したり合成するのかの詳細が異なっています。しかし一般的に AudioNode は ( 持っていれば ) 入力を処理し、( 持っていれば ) その出力にオーディオ信号を送り出します。

それぞれの出力は 1 つ以上のチャンネルを持っています。正確なチャンネル数はそれぞれの AudioNode の詳細に依存します。

出力は 1 つ以上の AudioNode の入力に接続でき、つまり ファンアウト がサポートされています。入力は初期状態では接続されていません。しかし、1 つ以上の AudioNode の出力から接続する事ができ、即ち、ファンインがサポートされています。 AudioNode の出力を AudioNode の入力に接続するため connect() メソッドが呼ばれたとき、それをその入力への 接続 と呼びます。

各 AudioNode の 入力 はその時々で特定のチャンネル数を持ちます。この数はその入力への 接続 によって変化します。もし入力が接続を持っていない場合、チャンネル数は 1 で無音となります。

AudioNode は 各々の 入力 について、その入力へのすべての接続のミキシングを行います。この詳細な基準となる要件については § 4 チャンネルのアップミックスとダウンミックス セクションを参照してください。

AudioNode の入力および内部の処理は、そのノードが出力を接続されているか、またそれらの出力が AudioContext の AudioDestinationNode に最終的に到達しているかどうかに関わらず、 AudioContext の時刻を踏まえて継続的に行われます。

[Exposed=Window]
 interface AudioNode : EventTarget {
   AudioNode connect (AudioNode destinationNode,
                      optional unsigned long output = 0,
                      optional unsigned long input = 0);
   undefined connect (AudioParam destinationParam, optional unsigned long output = 0);
   undefined disconnect ();
   undefined disconnect (unsigned long output);
   undefined disconnect (AudioNode destinationNode);
   undefined disconnect (AudioNode destinationNode, unsigned long output);
   undefined disconnect (AudioNode destinationNode,
                         unsigned long output,
                         unsigned long input);
   undefined disconnect (AudioParam destinationParam);
   undefined disconnect (AudioParam destinationParam, unsigned long output);
   readonly attribute BaseAudioContext context;
   readonly attribute unsigned long numberOfInputs;
   readonly attribute unsigned long numberOfOutputs;
   attribute unsigned long channelCount;
   attribute ChannelCountMode channelCountMode;
   attribute ChannelInterpretation channelInterpretation;
 };
 

1.5.1. AudioNode の作成 原文

AudioNode の作成には 2 つの方法があります: 特定のインターフェースのコンストラクタを使用する方法、と BaseAudioContext または AudioContext の ファクトリーメソッド を使用する方法です。

AudioNode のコンストラクタの最初の引数として渡される BaseAudioContext は、作成される AudioNode が 関連する BaseAudioContext と呼ばれます。同様に、ファクトリーメソッドを使用する場合、 AudioNode の関連する BaseAudioContext は このファクトリーメソッドが呼び出される BaseAudioContext です。