OfflineAudioContext:suspend() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

suspend() 方法是 OfflineAudioContext 介面的一部分,它會在指定的時間安排音訊上下文的時間程序暫停,並返回一個 Promise。這對於在 `OfflineAudioContext` 上同步操作音訊圖非常有用。

請注意,暫停的最大精度是渲染量子的大小,指定的暫停時間將向下舍入到最近的渲染量子邊界。因此,不允許在同一個量化幀安排多個暫停。此外,應在上下文未執行時進行安排,以確保精確暫停。

語法

js
suspend(suspendTime)

引數

suspendTime

一個浮點數,指定暫停時間(以秒為單位)。

返回值

一個 Promise,解析為 undefined

異常

當遇到任何異常時,Promise 將被拒絕。

InvalidStateError DOMException

如果量化幀號是以下之一,則返回

  • 一個負數
  • 小於或等於當前時間
  • 大於或等於總渲染時長
  • 由另一個同一時間的 suspend 安排

規範

規範
Web Audio API
# dom-offlineaudiocontext-suspend

瀏覽器相容性