音频开发 / 系统课时
创建 AudioContext 并观察运行状态
创建 AudioContext 并观察运行状态
本篇解决浏览器音频链路的第一步:创建 AudioContext,读取它的运行状态,并通过用户操作安全地启动或关闭上下文。完成后你能判断音频为什么没有真正开始处理,而不是只盯着播放按钮排查。
学习目标
- 创建
AudioContext并读取state - 区分
suspended、running、closed的含义与转换方式 - 用用户手势调用
resume(),规避常见自动播放限制
三种状态分别意味着什么
AudioContext.state 最常见的值是 suspended、running 和 closed。suspended 表示音频时间线暂停推进,节点不会继续实时处理;running 表示上下文正在正常处理音频;closed 表示上下文已经永久关闭,不能再用 resume() 恢复。
浏览器可能因为自动播放策略让新建的上下文停在 suspended。因此“对象创建成功”并不等于“音频正在运行”,真正开始前应检查 state,并把 resume() 放到点击、触摸等用户操作触发的回调中。

跑通最小状态观察示例
下面的单文件示例可以直接保存为 index.html 后在浏览器打开。依次点击“启动音频”和“关闭上下文”;按钮点击属于用户手势,因此适合调用 resume(),而关闭后不能再恢复同一个上下文。
<!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>预期输出
initial: <INITIAL_STATE>
after resume: running
after close: closed<INITIAL_STATE> 可能是 suspended,也可能因浏览器策略与当前页面权限而直接是 running;后两行分别在点击对应按钮后出现。
监听状态变化而不是猜测
当应用还包含页面切后台、系统音频打断或显式 suspend() 时,只在初始化阶段读一次 state 不够。可以监听 statechange,在状态真的改变后更新 UI 或诊断日志。
片段示例,依赖前一个示例中已经创建的 ctx:
ctx.addEventListener("statechange", () => {
console.log(`AudioContext state: ${ctx.state}`);
});验证时切换 resume()、suspend() 或 close(),控制台应打印对应的新状态。
浏览器限制与边界
自动播放限制的核心不是“必须创建两次上下文”,而是需要在允许的用户激活时机启动它。resume() 返回 Promise,应等待完成后再启动依赖实时处理的逻辑。上下文一旦进入 closed 就是终态;如果页面还要继续处理音频,应重新设计生命周期,而不是反复对已关闭对象调用 resume()。