AudioScheduledSourceNode: ended イベント

Baseline 広く利用可能

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

ended は AudioScheduledSourceNode インターフェイスのイベントで、ソースノードの再生が停止したときに発生します。

このイベントは、AudioScheduledSourceNode の再生が停止したときに発生します。理由は、所定の停止時刻に達したか、音声の全時間が再生されたか、またはバッファーの全体が再生されたかのいずれかです。

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

構文

このイベント名を addEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("ended", (event) => { })

onended = (event) => { }

一般的な Event です。

この単純な例では、 ended イベントに対するイベントリスナーを設定し、ノードの再生が停止したときにユーザーインターフェイスに［Start］ボタンを表示できるようにしています。

node.addEventListener("ended", () => {
  document.getElementById("startButton").disabled = false;
});

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

node.onended = () => {
  document.getElementById("startButton").disabled = false;
};

ended イベントの使用例は、 audio-buffer の例 (GitHub) を参照してください。

仕様書
Web Audio API # dom-audioscheduledsourcenode-onended

このページは MDN の貢献者によって 2024年7月6日に最終更新されました。