音频开发 / 系统课时

处理页面销毁与资源释放

处理页面销毁与资源释放

浏览器音频功能停止后,如果只把界面隐藏而没有释放底层资源,麦克风指示灯、媒体轨道和 AudioContext 仍可能继续存活。本节把停止轨道、断开节点和关闭上下文收敛到一个可重复调用的清理入口,并用于组件卸载、设备切换和页面离开。

学习目标

  • 区分 MediaStreamTrack、AudioNode 与 AudioContext 各自需要释放的资源
  • 实现可以安全重复调用的音频清理函数,并在切换输入设备时重建链路
  • 在组件卸载和页面离开阶段触发清理,并验证麦克风与上下文已经停止

释放顺序为什么重要

一条麦克风处理链通常同时占用三类资源:MediaStreamTrack 持有采集设备,AudioNode 构成处理图,AudioContext 持有音频执行环境。只调用其中一个停止动作,并不能保证另外两层同步消失。

推荐把一次完整会话的销毁顺序固定为:先停止所有媒体轨道,让浏览器尽快释放麦克风;再对仍持有的节点执行 disconnect(),切断处理图引用;最后调用 AudioContext.close()。关闭后的 AudioContext 不能再次恢复,下一次会话应创建新的实例。

浏览器音频资源释放生命周期

把清理集中到一个入口

下面的完整浏览器脚本会创建开始、停止和设备选择控件。切换设备时先释放旧会话,再针对新设备重新申请媒体流和 AudioContext;多次点击停止也不会因为资源已经销毁而抛错。

js
const panel = document.createElement('div');
const startButton = document.createElement('button');
const stopButton = document.createElement('button');
const deviceSelect = document.createElement('select');
const status = document.createElement('pre');

startButton.textContent = '启动麦克风';
stopButton.textContent = '释放资源';
panel.append(startButton, stopButton, deviceSelect, status);
document.body.append(panel);

let session = null;

function writeStatus(message) {
  status.textContent += `${message}\n`;
}

async function releaseAudio() {
  if (!session) {
    return;
  }

  const { stream, source, muteGain, context } = session;
  session = null;

  // 先释放采集设备,再拆除音频图。
  for (const track of stream.getTracks()) {
    track.stop();
  }

  source.disconnect();
  muteGain.disconnect();

  if (context.state !== 'closed') {
    await context.close();
  }

  writeStatus(`资源已释放,AudioContext=${context.state}`);
}

async function refreshDevices(selectedId = '') {
  const devices = await navigator.mediaDevices.enumerateDevices();
  const inputs = devices.filter((device) => device.kind === 'audioinput');

  deviceSelect.replaceChildren();
  for (const input of inputs) {
    const option = document.createElement('option');
    option.value = input.deviceId;
    option.textContent = input.label || `麦克风 ${deviceSelect.length + 1}`;
    option.selected = input.deviceId === selectedId;
    deviceSelect.append(option);
  }
}

async function startAudio(deviceId = '') {
  await releaseAudio();

  const audio = deviceId
    ? { deviceId: { exact: deviceId } }
    : true;
  const stream = await navigator.mediaDevices.getUserMedia({ audio });
  const context = new AudioContext();
  await context.resume();

  const source = context.createMediaStreamSource(stream);
  const muteGain = context.createGain();
  // 保持处理图活动,但不把麦克风直接回放到扬声器,避免啸叫。
  muteGain.gain.value = 0;
  source.connect(muteGain).connect(context.destination);

  session = { stream, source, muteGain, context };
  await refreshDevices(stream.getAudioTracks()[0]?.getSettings().deviceId || '');
  writeStatus(`资源已建立,AudioContext=${context.state}`);
}

startButton.addEventListener('click', () => {
  void startAudio(deviceSelect.value).catch((error) => {
    writeStatus(`${error.name}: ${error.message}`);
  });
});

stopButton.addEventListener('click', () => {
  void releaseAudio();
});

deviceSelect.addEventListener('change', () => {
  if (session) {
    void startAudio(deviceSelect.value).catch((error) => {
      writeStatus(`${error.name}: ${error.message}`);
    });
  }
});

window.addEventListener('pagehide', () => {
  void releaseAudio();
}, { once: true });

预期结果

text
资源已建立,AudioContext=running
资源已释放,AudioContext=closed

实际设备名称与权限提示由浏览器决定。代码需要在 HTTPS 或 localhost 等允许媒体采集的安全上下文中运行,并由用户授予麦克风权限。

在组件和页面生命周期中接入

组件框架不需要重新实现一套销毁逻辑,只需要让组件的卸载回调调用同一个 releaseAudio()。这样,正常点击停止、路由切换、组件卸载都走同一条资源回收路径,避免某个入口漏掉轨道或节点。

页面离开可使用 pagehide 作为兜底,但不要把关键业务持久化依赖在异步关闭完成之后。示例中的 track.stop() 与 disconnect() 会在 releaseAudio() 第一个 await 之前同步执行,而 AudioContext.close() 属于后续的异步关闭请求。

如果应用只是频繁热切换麦克风,并且需要保留同一套效果器和分析节点,也可以只停止旧轨道、断开旧的 MediaStream 源,再把新源接入现有 AudioContext。只有当整个音频会话随设备一起重建时,才需要像本例一样关闭旧上下文。

验证没有留下活动资源

停止后应同时检查三个层面:原媒体轨道的 readyState 变为 ended,处理节点不再被业务代码持有或继续连接,上下文状态最终为 closed。麦克风权限本身可能仍被浏览器记住,这不代表设备仍在采集。

最常见的泄漏来自重复启动:每次点击启动都新建流和上下文,却没有先销毁旧实例。另一个常见问题是在页面销毁时只关闭 AudioContext,没有停止 MediaStreamTrack。把创建与清理成对设计,并让所有退出路径调用同一个幂等清理函数,才能保证音频会话真正结束。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理页面销毁与资源释放

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

登录哪都通