AudioContext 创建失败主因是未在用户交互后调用 resume(),初始状态为 "suspended";须在点击等事件中调用 resume() 并检查 state 为 "running",复用实例、避免重复创建。

AudioContext 创建失败的常见原因和修复方式
大多数音频操作失败,是因为 AudioContext 未在用户交互(如点击、触摸)后启动。现代浏览器禁止自动播放音频上下文,直接在页面加载时 new AudioContext() 会创建但处于“suspended”状态,后续调用 start() 或连接节点会静默失败。
- 必须在用户手势事件中首次调用
resume(),例如:button.addEventListener('click', () => audioCtx.resume()) - 检查状态用
audioCtx.state—— 初始为"suspended",成功恢复后才是"running" - 不要重复创建
AudioContext实例;复用全局实例更稳定,避免资源泄漏
用 OscillatorNode 播放基础音调的最小可行代码
想快速验证音频通路是否正常?不用加载音频文件,直接用振荡器生成正弦波是最轻量的方式。注意:OscillatorNode 是一次性节点,start() 后必须显式 stop(),否则会持续占用资源。
const audioCtx = new (window.AudioContext || window.webkitAudioContext)(); const osc = audioCtx.createOscillator(); osc.type = 'sine'; osc.frequency.value = 440; // A4 音符 osc.connect(audioCtx.destination); osc.start(); // 必须在 resume() 之后调用 // 1 秒后停止 setTimeout(() => osc.stop(), 1000);
如何把 元素接入 Web Audio API 做实时处理
原生 标签只能控制播放/暂停/音量,若要加滤波、变调、频谱分析等效果,必须通过 MediaElementAudioSourceNode 接入音频上下文。关键点是:不能在 audio.src 设置后立刻连接,需等 loadedmetadata 事件触发。
- 确保
audio元素设置了crossOrigin="anonymous"(尤其加载跨域音频时),否则创建源节点会报InvalidStateError - 用
audioCtx.createMediaElementSource(audioEl)获取源节点,再连接到BiquadFilterNode或GainNode等处理器 - 不要手动调用
audio.play()—— 交给 Web Audio 控制更精准;可改用sourceNode.mediaElement.play()同步触发
录音并导出为 WAV 文件的注意事项
Web Audio API 本身不提供录音接口,得靠 MediaRecorder 或手动采集 ScriptProcessorNode(已废弃)——现在推荐用 AudioWorklet 或 OfflineAudioContext + MediaRecorder 组合。最容易被忽略的是采样率和位深兼容性:
立即学习“Java免费学习笔记(深入)”;
-
MediaRecorder的mimeType不支持所有浏览器导出 WAV;Chrome 支持"audio/wav",Firefox 默认只输出"audio/webm" - 若需 WAV,建议用
OfflineAudioContext渲染后手动生成 WAV header(16-bit PCM,little-endian),再转为Blob - 长时间录音慎用
AudioBuffer.copyFromChannel()频繁读取 —— 可能引发主线程卡顿,应使用AudioWorklet在后台线程处理
audioCtx.state === "running",否则所有节点连接都只是“看起来连上了”。











