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);

如何把 <audio></audio> 元素接入 Web Audio API 做实时处理

原生 <audio></audio> 标签只能控制播放/暂停/音量，若要加滤波、变调、频谱分析等效果，必须通过 MediaElementAudioSourceNode 接入音频上下文。关键点是：不能在 audio.src 设置后立刻连接，需等 loadedmetadata 事件触发。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 确保 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"，否则所有节点连接都只是“看起来连上了”。