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 April 2021.

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

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

構文

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

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

oncomplete = (event) => {};

イベント型

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

Event OfflineAudioCompletionEvent

イベントプロパティ

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

OfflineAudioCompletionEvent.renderedBuffer 読取専用

AudioBuffer で、 OfflineAudioContext の処理結果が入っています。

例

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

js
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 プロパティを使用して、イベントハンドラーを設定することもできます。

js
const offlineAudioCtx = new OfflineAudioContext();

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

仕様書

Specification
Web Audio API
# OfflineAudioCompletionEvent
Web Audio API
# dom-offlineaudiocontext-oncomplete

ブラウザーの互換性

BCD tables only load in the browser

関連情報