音频开发 / 系统课时
把 audio 元素接入音频图
把 audio 元素接入音频图
本篇把一个可正常播放的 HTMLAudioElement 接入 Web Audio 节点图,并继续从扬声器输出声音。你会保留 <audio> 的加载与播放控制能力,同时获得 GainNode 等 Web Audio 节点提供的处理能力。
学习目标
- 使用
createMediaElementSource()把<audio>转成音频图的输入节点 - 理解媒体元素、
MediaElementAudioSourceNode与destination的职责边界 - 保持正常播放,并为后续音量、滤波或分析处理预留节点位置
接入后发生了什么
HTMLAudioElement 仍然负责资源加载、播放、暂停、进度与原生 controls;createMediaElementSource(audio) 只是把它产生的音频信号引入当前 AudioContext。之后必须把这个 source 节点连到 ctx.destination,或先经过其他处理节点再连到 destination,声音才会到达默认输出设备。

最小可用链路可以写成 audio → source → gain → destination。如果暂时不需要处理,也可以直接 source.connect(ctx.destination);本例加入 GainNode,方便验证音频确实经过了节点图。
跑通可播放的完整示例
下面示例不依赖外部 URL:用户从本机选择一个音频文件,再点击“接入并播放”。对象 URL 只在当前页面内使用,页面关闭时会被释放。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>Media element source</title>
</head>
<body>
<input id="file" type="file" accept="audio/*">
<audio id="player" controls></audio>
<button id="start">接入并播放</button>
<script>
const fileInput = document.querySelector("#file");
const player = document.querySelector("#player");
const startButton = document.querySelector("#start");
const AudioContextClass = window.AudioContext || window.webkitAudioContext;
const ctx = new AudioContextClass();
const source = ctx.createMediaElementSource(player);
const gain = ctx.createGain();
// 媒体元素的声音进入节点图后,只沿这一条处理链到达输出。
source.connect(gain);
gain.connect(ctx.destination);
gain.gain.value = 0.8;
let objectUrl = null;
// 使用本地文件避免依赖跨域音频地址,并及时释放旧对象 URL。
fileInput.addEventListener("change", () => {
if (objectUrl) URL.revokeObjectURL(objectUrl);
const file = fileInput.files[0];
if (!file) return;
objectUrl = URL.createObjectURL(file);
player.src = objectUrl;
});
startButton.addEventListener("click", async () => {
if (!player.src) {
console.log("请先选择音频文件");
return;
}
if (ctx.state === "suspended") {
await ctx.resume();
}
await player.play();
console.log("audio graph ready");
});
window.addEventListener("beforeunload", () => {
if (objectUrl) URL.revokeObjectURL(objectUrl);
});
</script>
</body>
</html>预期输出
audio graph ready同时页面中的 <audio> 正常发声,且 GainNode 的线性增益值为 0.8。如果浏览器首次创建上下文时处于 suspended,点击按钮后会先执行 resume() 再播放。
不要重复创建同一个媒体源
同一个 HTMLMediaElement 不应反复调用 createMediaElementSource() 创建新的源节点;应保存第一次返回的 MediaElementAudioSourceNode 并重复连接或调整后续处理节点。否则浏览器会拒绝再次关联,常见结果是抛出 InvalidStateError。
还要避免把同一信号同时通过两条路径接到 destination。例如既连接 source → destination,又连接 source → gain → destination,两路信号会在输出端叠加,导致音量变化,排查时很容易误以为是 GainNode 参数失效。
验证链路是否真的经过音频图
最简单的验证不是只看 <audio> 是否在播放,而是改变 gain.gain.value。把它从 0.8 改为 0 后重新播放,如果声音完全静音,说明媒体元素的输出确实已经进入 Web Audio 图,并通过 GainNode 到达 destination。