OfflineAudioContext.suspend()

suspend()OfflineAudioContext インターフェイスのメソッドで、指定した時刻に音声コンテキストの時間進行の停止をスケジュールし、プロミスを返します。これは一般に、 OfflineAudioContext 上で音声グラフを同期的に操作する時刻に使用されます。

サスペンドの最大精度はレンダー量のサイズであり、指定したサスペンド時刻は最も近いレンダー量の境界に切り捨てられることに注意してください。 このため、同じ量子化フレームで複数のサスペンドをスケジュールすることはできません。また、正確なサスペンドを確保するために、スケジューリングはコンテキストが実行されていない間に行われるべきです。

構文

js
suspend(suspendTime)

引数

suspendTime

数値で、停止時間を秒単位で指定します。

返値

Promise で、 undefined に解決します。

例外

例外が発生した場合、プロミスは拒否されます。

InvalidStateError DOMException

量子化フレーム番号が以下のいずれかである場合に返されます。

  • 負の数
  • 現在の時刻よりいくつか小さいか等しい。
  • レンダリング総時間より大きいか、等しい。
  • 同じ時刻に他のサスペンドによってスケジュールされている。

仕様書

Specification
Web Audio API
# dom-offlineaudiocontext-suspend

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
suspend

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.