OfflineAudioContext: complete 事件

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

OfflineAudioContext 介面的 complete 事件在離線音訊上下文渲染完成後觸發。

此事件不可取消,也不會冒泡。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

oncomplete = (event) => { }

事件型別

一個 OfflineAudioCompletionEvent。繼承自 Event

Event OfflineAudioCompletionEvent

事件屬性

還繼承了其父類 Event 的屬性。.

OfflineAudioCompletionEvent.renderedBuffer 只讀

一個包含處理 OfflineAudioContext 結果的 AudioBuffer

示例

處理完成後,您可能希望使用 complete 事件處理程式來提示使用者音訊現在可以播放,並啟用播放按鈕。

js
const offlineAudioCtx = new OfflineAudioContext();

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

您也可以透過 oncomplete 屬性來設定事件處理程式。

js
const offlineAudioCtx = new OfflineAudioContext();

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

規範

規範
Web Audio API
# OfflineAudioCompletionEvent
Web Audio API
# dom-offlineaudiocontext-oncomplete

瀏覽器相容性

另見