BaseAudioContext: state プロパティ

Baseline 広く利用可能

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

state は BaseAudioContext インターフェイスの読み取り専用プロパティで、現在の AudioContext の状態を返します。

値

文字列です。取りうる値は以下の通りです。

次のスニペットは AudioContext states のデモ(ライブ実行で確認)の一部です。 onstatechange ハンドラーは、状態が変わるたびにコンソールにログを出力するために使われています。

audioCtx.onstatechange = () => {
 console.log(audioCtx.state);
};

iOS の Safari では、ユーザーが(タブの切り替え、ブラウザーの最小化、画面のオフなどで)ページを離れると、音声コンテキストの状態が "interrupted" に変わり、再開させる必要があります。例えば次のようにします。

function play() {
 if (audioCtx.state === "interrupted") {
 audioCtx.resume().then(() => play());
 return;
 }
 // play() 関数の残り
}

仕様書
Web Audio API # dom-baseaudiocontext-state

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