OfflineAudioContext
OfflineAudioContext インターフェイスは AudioContext インターフェイスの一種で、 AudioNode をつなげて造られる音声処理グラフを表しています。通常の AudioContext と異なり、OfflineAudioContext で処理された音声はハードウェアから再生されることはありません。処理された結果は AudioBuffer に出力されます。
EventTarget BaseAudioContext OfflineAudioContext
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 35 | 12 | 25 | 14.1 | 35 | 14.5 | |
| ウェブオーディオ API の OfflineAudioCompletionEvent このインターフェイスは、 OfflineAudioContext の処理が終了した際に発生するイベントを表します。 OfflineAudioContext/complete_event イベントがこのインターフェイスで使用されます。 | 14 | 12 | 25 | 6 | 18 | 6 |
| OfflineAudioCompletionEvent() はウェブオーディオ API のコンストラクターで、新しい OfflineAudioCompletionEvent オブジェクトを生成します。 | 57 | 79 | 53 | 14 | 57 | 14 |
| renderedBuffer は OfflineAudioCompletionEvent インターフェイスの読み取り専用プロパティで、 OfflineAudioContext の処理結果が入った AudioBuffer を返します。 | 14 | 12 | 25 | 6 | 18 | 6 |
| complete は OfflineAudioContext インターフェイスのイベントで、オフライン音声コンテキストのレンダリングが完了したときに発行されます。 | 25 | 12 | 25 | 7 | 25 | 7 |
| length は OfflineAudioContext インターフェイスのプロパティで、バッファーのサイズをサンプルフレーム単位で表した整数を返します。 | 51 | 14 | 49 | 14.1 | 51 | 14.5 |
| OfflineAudioContext() コンストラクターは、ウェブオーディオ API の一部で、新しい OfflineAudioContext オブジェクトインスタンスを生成して返します。これは音声出力機器ではなく AudioBuffer に音声を出力することができるものです。 | 35 | 12 | 25 | 14.1 | 35 | 14.5 |
OfflineAudioContext (options parameter) `options` パラメータ(すべてのパラメータを単一の辞書として受け付けます) | 62 | 79 | 57 | 14.1 | 62 | 14.5 |
| resume() は OfflineAudioContext インターフェイスのメソッドで、 一時停止していた音声コンテキストの時刻の進行を再開します。 OfflineAudioContext は音声ハードウェアを必要としないので、プロミスはすぐに解決されます。 | 41 | 14 | 40 | 9 | 41 | 9 |
| startRendering() は のメソッドで、オーディオグラフのレンダリングを開始します。このインターフェイスは、現在の接続と現在のスケジュール変更を考慮して、音声グラフのレンダリングを開始します。 | 25 | 12 | 25 | 7 | 25 | 7 |
startRendering (returns promise) Promise` を返す。 | 42 | ≤18 | 37 | 14.1 | 42 | 14.5 |
| suspend() は インターフェイスのメソッドで、指定した時刻に音声コンテキストの時間進行の停止をスケジュールし、プロミスを返します。これは一般に、 OfflineAudioContext 上で音声グラフを同期的に操作する時刻に使用されます。 | 41 | 14 | | 9 | 41 | 9 |
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (14.1)
- ベンダープレフィックス付きで対応: webkit (7)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (14.5)
- ベンダープレフィックス付きで対応: webkit (7)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (14.1)
- ベンダープレフィックス付きで対応: webkit (7)
- このバージョンで機能が削除されました (57)
- ベンダープレフィックス付きで対応: webkit (25)
- このバージョンで機能が削除されました (14.5)
- ベンダープレフィックス付きで対応: webkit (7)
- このブラウザでは部分的にしか実装されていません
- このメソッドは存在しますが、常に `NotSupportedError` を発生させて拒否されます。バグ 1265406 を参照してください。
実務での使いどころ
-
OfflineAudioContext の活用
OfflineAudioContext インターフェイスは AudioContext インターフェイスの一種で、 AudioNode をつなげて造られる音声処理グラフを表しています。
注意点
- 古いブラウザでは対応していない場合がある。
実装メモ
- 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。