OfflineAudioContext: suspend() Methode

Die suspend()-Methode des OfflineAudioContext-Interfaces plant eine Unterbrechung des Zeitfortschritts im Audio-Kontext zu einer angegebenen Zeit und gibt ein Promise zurück. Dies ist insbesondere nützlich, um den Audiograph synchron im OfflineAudioContext zu manipulieren.

Beachten Sie, dass die maximale Präzision der Unterbrechung durch die Größe des Render-Quantums bestimmt wird und die angegebene Unterbrechungszeit auf die nächste Grenze des Render-Quantums abgerundet wird. Aus diesem Grund ist es nicht erlaubt, mehrere Unterbrechungen am selben quantisierten Frame zu planen. Außerdem sollte die Planung erfolgen, während der Kontext nicht läuft, um die genaue Unterbrechung sicherzustellen.

Syntax

js
suspend(suspendTime)

Parameter

suspendTime

Eine Gleitkommazahl, die die Unterbrechungszeit in Sekunden angibt.

Rückgabewert

Ein Promise, das zu undefined führt.

Ausnahmen

Das Promise wird abgelehnt, wenn irgendeine Ausnahme auftritt.

InvalidStateError DOMException

Wird zurückgegeben, wenn die quantisierte Frame-Nummer eine der folgenden ist:

  • eine negative Zahl
  • kleiner oder gleich der aktuellen Zeit
  • größer oder gleich der gesamten Render-Dauer
  • für dieselbe Zeit von einer anderen Unterbrechung geplant

Spezifikationen

Specification
Web Audio API
# dom-offlineaudiocontext-suspend

Browser-Kompatibilität

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.