OfflineAudioContext: complete イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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;
};