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

BCD tables only load in the browser