AudioContext: suspend() 方法

Baseline 已广泛支持

此特性已得到良好支持，可在多种设备和浏览器版本上使用。自 2021 年 4 月起，所有浏览器均已支持此特性。

AudioContext 接口的 suspend() 方法会暂停音频上下文中的时间进程，暂时停止音频硬件访问，并在此过程中减少 CPU/电池使用量——如果你希望应用程序在一段时间内不使用音频上下文时关闭音频硬件，这将非常有用。

如果对 OfflineAudioContext 调用此方法，将抛出 INVALID_STATE_ERR 异常。

语法

suspend()

参数

无。

返回值

一个解析为 undefined 的 Promise。如果上下文已被关闭，则 Promise 会被拒绝。

示例

以下代码片段取自我们的 AudioContext 状态演示（在线查看）。当点击 suspend/resume 按钮时，会查询 AudioContext.state——如果状态是 running，则调用 suspend()；如果状态是 suspended，则调用 resume()。在每种情况下，一旦 Promise 解析，按钮的文本标签都会相应更新。

susResBtn.onclick = () => {
  if (audioCtx.state === "running") {
    audioCtx.suspend().then(() => {
      susResBtn.textContent = "Resume context";
    });
  } else if (audioCtx.state === "suspended") {
    audioCtx.resume().then(() => {
      susResBtn.textContent = "Suspend context";
    });
  }
};

规范

规范
Web Audio API # dom-audiocontext-suspend

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2024年10月8日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题