音频开发 / 系统课时
处理页面销毁与资源释放
处理页面销毁与资源释放
浏览器音频功能停止后,如果只把界面隐藏而没有释放底层资源,麦克风指示灯、媒体轨道和 AudioContext 仍可能继续存活。本节把停止轨道、断开节点和关闭上下文收敛到一个可重复调用的清理入口,并用于组件卸载、设备切换和页面离开。
学习目标
- 区分 MediaStreamTrack、AudioNode 与 AudioContext 各自需要释放的资源
- 实现可以安全重复调用的音频清理函数,并在切换输入设备时重建链路
- 在组件卸载和页面离开阶段触发清理,并验证麦克风与上下文已经停止
释放顺序为什么重要
一条麦克风处理链通常同时占用三类资源:MediaStreamTrack 持有采集设备,AudioNode 构成处理图,AudioContext 持有音频执行环境。只调用其中一个停止动作,并不能保证另外两层同步消失。
推荐把一次完整会话的销毁顺序固定为:先停止所有媒体轨道,让浏览器尽快释放麦克风;再对仍持有的节点执行 disconnect(),切断处理图引用;最后调用 AudioContext.close()。关闭后的 AudioContext 不能再次恢复,下一次会话应创建新的实例。

把清理集中到一个入口
下面的完整浏览器脚本会创建开始、停止和设备选择控件。切换设备时先释放旧会话,再针对新设备重新申请媒体流和 AudioContext;多次点击停止也不会因为资源已经销毁而抛错。
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 });预期结果
资源已建立,AudioContext=running
资源已释放,AudioContext=closed实际设备名称与权限提示由浏览器决定。代码需要在 HTTPS 或 localhost 等允许媒体采集的安全上下文中运行,并由用户授予麦克风权限。
在组件和页面生命周期中接入
组件框架不需要重新实现一套销毁逻辑,只需要让组件的卸载回调调用同一个 releaseAudio()。这样,正常点击停止、路由切换、组件卸载都走同一条资源回收路径,避免某个入口漏掉轨道或节点。
页面离开可使用 pagehide 作为兜底,但不要把关键业务持久化依赖在异步关闭完成之后。示例中的 track.stop() 与 disconnect() 会在 releaseAudio() 第一个 await 之前同步执行,而 AudioContext.close() 属于后续的异步关闭请求。
如果应用只是频繁热切换麦克风,并且需要保留同一套效果器和分析节点,也可以只停止旧轨道、断开旧的 MediaStream 源,再把新源接入现有 AudioContext。只有当整个音频会话随设备一起重建时,才需要像本例一样关闭旧上下文。
验证没有留下活动资源
停止后应同时检查三个层面:原媒体轨道的 readyState 变为 ended,处理节点不再被业务代码持有或继续连接,上下文状态最终为 closed。麦克风权限本身可能仍被浏览器记住,这不代表设备仍在采集。
最常见的泄漏来自重复启动:每次点击启动都新建流和上下文,却没有先销毁旧实例。另一个常见问题是在页面销毁时只关闭 AudioContext,没有停止 MediaStreamTrack。把创建与清理成对设计,并让所有退出路径调用同一个幂等清理函数,才能保证音频会话真正结束。