AudioContext 的 suspend() 和 resume() 用于控制整个音频上下文的激活状态，解决浏览器自动播放策略限制；需在用户交互后调用 resume() 才能创建节点、调度音频，suspend() 则用于节能或状态重置。
AudioContext 的 suspend() 和 resume() 方法用于控制音频上下文的运行状态，主要解决自动播放策略（autoplay policy）限制下音频无法初始化或播放的问题。它们不直接控制某段音频的暂停/继续，而是管理整个音频处理图（audio graph）是否处于激活、可调度状态。
为什么需要 suspend / resume？
现代浏览器（Chrome、Safari、Edge 等）要求用户主动交互（如点击、触摸）后才能启动音频上下文。未激活的 AudioContext 处于“suspended”状态：不能创建音源节点、不能调度事件（如 start()）、currentTime 不更新。调用 resume() 是进入“running”状态的必要前提。
基本用法：在用户交互中恢复上下文
最常见场景是页面加载后，等用户点击按钮再启用音频：
- 创建 AudioContext 后默认处于 suspended 状态（尤其在非交互时机创建时）
- 在 click/touchstart 等事件回调中调用
audioContext.resume() - 成功后返回 Promise，可链式处理后续音频操作
示例：
立即学习“前端免费学习笔记（深入）”；
const audioContext = new (window.AudioContext || window.webkitAudioContext)();
// 页面加载时上下文已创建，但可能被挂起
document.getElementById('playBtn').addEventListener('click', async () => {
try {
await audioContext.resume(); // 恢复上下文
console.log('AudioContext is now running:', audioContext.state); // → 'running'
// 此时可安全创建 Oscillator、decodeAudioData、connect 节点等
const oscillator = audioContext.createOscillator();
oscillator.connect(audioContext.destination);
oscillator.start();
} catch (err) {
console.error('Failed to resume audio context:', err);
}
});
何时使用 suspend()？
suspend() 主动将上下文切回 suspended 状态，通常用于：
- 节省资源：长时间无音频活动时暂停处理（如背景音乐暂停后）
- 响应页面可见性变化（如切换到其他标签页）
- 配合音频策略做状态重置（例如退出播放模式前清理）
注意：suspend() 也返回 Promise，但失败概率较低；调用后 state 变为 suspended，所有定时调度（如 start(when)）会被推迟，直到再次 resume()。
监听状态变化与错误防护
建议监听 statechange 事件，并检查 audioContext.state 值（"suspended" / "running" / "closed"）：
audioContext.onstatechange = () => {
console.log('AudioContext state changed to:', audioContext.state);
};
// 避免重复 resume（比如多次点击）
if (audioContext.state === 'suspended') {
audioContext.resume();
}
若 resume 失败（如用户未交互、权限被拒），Promise 会 reject，务必用 try/catch 或 .catch() 处理，避免静音无提示。
