离线音频上下文: suspend() 方法

suspend() 方法是 OfflineAudioContext 接口的方法，它在指定时间安排暂停音频上下文的时间进程，并返回一个 Promise。这通常在 OfflineAudioContext 上同步操作音频图时很有用。

请注意，暂停的最大精度是渲染量子的大小，指定的时间将被向下舍入到最接近的渲染量子边界。因此，不允许在同一量化帧中安排多个暂停。另外，应在上下文未运行时进行调度，以确保精确的暂停。

语法

js
suspend(suspendTime)

参数

suspendTime

指定暂停时间的浮点数，单位为秒。

返回值

一个 Promise，解析为 undefined。

异常

遇到任何异常时，Promise 将被拒绝。

InvalidStateError DOMException

如果量化帧编号为以下之一，则返回：

  • 负数
  • 小于或等于当前时间
  • 大于或等于总渲染时间
  • 由另一个 suspend 在同一时间安排

规范

规范
Web 音频 API
# dom-offlineaudiocontext-suspend

浏览器兼容性

BCD 表格仅在浏览器中加载