使用共享 GainNode 实现多路音频协同静音：创建单个 gainNode，所有音频源均连接至它再输出到 destination；设 gain.value = 0 即刻静音，恢复时用 setValueAtTime 确保时序精准，避免 disconnect 或重复连接。
使用 AudioContext 的 GainNode 实现多路音频协同静音，核心是让所有音频源共享同一个增益控制节点，而非各自管理静音状态。这样只需调节一个 gain.value，就能统一控制全部音频输出的音量（包括完全静音）。
创建共享 GainNode 并连接各音频源
不要为每路音频单独创建 GainNode，而是创建一个全局增益节点，作为所有音频路径的“总控阀门”：
- 调用
audioContext.createGain()创建唯一GainNode - 将每路音频源（如
AudioBufferSourceNode、MediaStreamAudioSourceNode等）都连接到该GainNode，再由它连接到destination - 确保没有音频源绕过该节点直接连到
destination，否则静音失效
统一控制静音：设置 gain.value = 0
静音的本质是将增益设为 0（线性值），而非 -Infinity（虽等效但不必要）：
-
gainNode.gain.value = 0即刻实现完全静音，计算开销低，响应即时 - 恢复时设为
1（或原目标音量），避免突兀跳变；可配合exponentialRampToValueAtTime实现平滑淡出/入 - 切勿用
gainNode.disconnect()模拟静音——这会断开信号流，再连接需重新调度，且易引发时序问题
支持动态增益调节与跨源同步
多个音频源共享同一 GainNode 后，天然具备增益同步能力：
立即学习“前端免费学习笔记（深入）”；
- 即使某路音频中途启动（如用户点击播放新音效），只要它连接到该
GainNode，就会自动受当前静音状态影响 - 可在任意时刻调用
gainNode.gain.setValueAtTime(0, audioContext.currentTime)确保精确时序静音 - 若需独立控制某一路（如仅静音背景音乐而保留语音），应将其接入另一个专用
GainNode，再与主增益节点混合（用ChannelMergerNode或额外GainNode分层）
注意事项与常见陷阱
实际使用中需规避几个典型问题：
-
避免重复连接：同一音频源多次
.connect(gainNode)会导致音量叠加甚至爆音，连接前可用node.disconnect()清理旧连接 -
注意 AudioContext 状态：静音操作前确保
audioContext.state === 'running'，否则需先触发用户交互（如点击）恢复上下文 -
Web Audio 时间精度：使用
setValueAtTime而非直接赋值，保证在音频渲染线程中精确生效，避免因 JS 主线程延迟导致静音滞后
