音频开发 / 系统课时

把 audio 元素接入音频图

把 audio 元素接入音频图

本篇把一个可正常播放的 HTMLAudioElement 接入 Web Audio 节点图,并继续从扬声器输出声音。你会保留 <audio> 的加载与播放控制能力,同时获得 GainNode 等 Web Audio 节点提供的处理能力。

学习目标

  • 使用 createMediaElementSource() 把 <audio> 转成音频图的输入节点
  • 理解媒体元素、MediaElementAudioSourceNode 与 destination 的职责边界
  • 保持正常播放,并为后续音量、滤波或分析处理预留节点位置

接入后发生了什么

HTMLAudioElement 仍然负责资源加载、播放、暂停、进度与原生 controls;createMediaElementSource(audio) 只是把它产生的音频信号引入当前 AudioContext。之后必须把这个 source 节点连到 ctx.destination,或先经过其他处理节点再连到 destination,声音才会到达默认输出设备。

audio 元素接入 Web Audio 音频图

最小可用链路可以写成 audio → source → gain → destination。如果暂时不需要处理,也可以直接 source.connect(ctx.destination);本例加入 GainNode,方便验证音频确实经过了节点图。

跑通可播放的完整示例

下面示例不依赖外部 URL:用户从本机选择一个音频文件,再点击“接入并播放”。对象 URL 只在当前页面内使用,页面关闭时会被释放。

html
<!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>

预期输出

text
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。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把 audio 元素接入音频图

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通