OfflineAudioContext: complete イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。

complete は OfflineAudioContext インターフェイスのイベントで、オフライン音声コンテキストのレンダリングが完了したときに発行されます。

このイベントはキャンセル不可で、バブリングしません。

構文

このイベント名を addEventListener() のようなメソッドで使用するか、イベントハンドラープロパティを設定するかします。

addEventListener("complete", (event) => {});

oncomplete = (event) => {};

イベント型

OfflineAudioCompletionEvent です。 Event を継承しています。

イベントプロパティ

親である Event からプロパティを継承しています。

OfflineAudioCompletionEvent.renderedBuffer 読取専用: AudioBuffer で、 OfflineAudioContext の処理結果が入っています。

例

処理が完全に終了したら、 complete イベントハンドラーを使用して、音声をこれで使用できることをユーザーに知らせ、再生ボタンを有効にしたいと思うかもしれません。

const offlineAudioCtx = new OfflineAudioContext();

offlineAudioCtx.addEventListener("complete", () => {
  console.log("Offline audio processing now complete");
  showModalDialog("Song processed and ready to play");
  playBtn.disabled = false;
});

また、 oncomplete プロパティを使用して、イベントハンドラーを設定することもできます。

const offlineAudioCtx = new OfflineAudioContext();

offlineAudioCtx.oncomplete = () => {
  console.log("Offline audio processing now complete");
  showModalDialog("Song processed and ready to play");
  playBtn.disabled = false;
};