OfflineAudioContext:suspend() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

suspend() 方法是 OfflineAudioContext 接口的一部分,它会在指定的时间安排音频上下文的时间进程暂停,并返回一个 Promise。这对于在 `OfflineAudioContext` 上同步操作音频图非常有用。

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

语法

js
suspend(suspendTime)

参数

suspendTime

一个浮点数,指定暂停时间(以秒为单位)。

返回值

一个 Promise,解析为 undefined

异常

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

InvalidStateError DOMException

如果量化帧号是以下之一,则返回

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

规范

规范
Web Audio API
# dom-offlineaudiocontext-suspend

浏览器兼容性