音频开发 / 系统课时

创建 AudioContext 并观察运行状态

创建 AudioContext 并观察运行状态

本篇解决浏览器音频链路的第一步:创建 AudioContext,读取它的运行状态,并通过用户操作安全地启动或关闭上下文。完成后你能判断音频为什么没有真正开始处理,而不是只盯着播放按钮排查。

学习目标

  • 创建 AudioContext 并读取 state
  • 区分 suspended、running、closed 的含义与转换方式
  • 用用户手势调用 resume(),规避常见自动播放限制

三种状态分别意味着什么

AudioContext.state 最常见的值是 suspended、running 和 closed。suspended 表示音频时间线暂停推进,节点不会继续实时处理;running 表示上下文正在正常处理音频;closed 表示上下文已经永久关闭,不能再用 resume() 恢复。

浏览器可能因为自动播放策略让新建的上下文停在 suspended。因此“对象创建成功”并不等于“音频正在运行”,真正开始前应检查 state,并把 resume() 放到点击、触摸等用户操作触发的回调中。

AudioContext 状态转换图

跑通最小状态观察示例

下面的单文件示例可以直接保存为 index.html 后在浏览器打开。依次点击“启动音频”和“关闭上下文”;按钮点击属于用户手势,因此适合调用 resume(),而关闭后不能再恢复同一个上下文。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>AudioContext state</title>
</head>
<body>
  <button id="resume">启动音频</button>
  <button id="close">关闭上下文</button>
  <pre id="output"></pre>
  <script>
    const AudioContextClass = window.AudioContext || window.webkitAudioContext;
    const ctx = new AudioContextClass();
    const output = document.querySelector("#output");

    function log(label) {
      const line = `${label}: ${ctx.state}`;
      console.log(line);
      output.textContent += `${line}\n`;
    }

    log("initial");

    // 在用户手势回调中恢复上下文,避免把“已创建”误判为“正在运行”。
    document.querySelector("#resume").addEventListener("click", async () => {
      if (ctx.state === "suspended") {
        await ctx.resume();
      }
      log("after resume");
    });

    // close() 进入终态;后续不能再对同一个上下文 resume()。
    document.querySelector("#close").addEventListener("click", async () => {
      if (ctx.state !== "closed") {
        await ctx.close();
      }
      log("after close");
    });
  </script>
</body>
</html>

预期输出

text
initial: <INITIAL_STATE>
after resume: running
after close: closed

<INITIAL_STATE> 可能是 suspended,也可能因浏览器策略与当前页面权限而直接是 running;后两行分别在点击对应按钮后出现。

监听状态变化而不是猜测

当应用还包含页面切后台、系统音频打断或显式 suspend() 时,只在初始化阶段读一次 state 不够。可以监听 statechange,在状态真的改变后更新 UI 或诊断日志。

片段示例,依赖前一个示例中已经创建的 ctx:

js
ctx.addEventListener("statechange", () => {
  console.log(`AudioContext state: ${ctx.state}`);
});

验证时切换 resume()、suspend() 或 close(),控制台应打印对应的新状态。

浏览器限制与边界

自动播放限制的核心不是“必须创建两次上下文”,而是需要在允许的用户激活时机启动它。resume() 返回 Promise,应等待完成后再启动依赖实时处理的逻辑。上下文一旦进入 closed 就是终态;如果页面还要继续处理音频,应重新设计生命周期,而不是反复对已关闭对象调用 resume()。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 AudioContext 并观察运行状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通