音频开发 / 系统课时
把 MediaStream 接入音频图
把 MediaStream 接入音频图
拿到麦克风的 MediaStream 只是获得了浏览器媒体流,还不能直接使用 Web Audio API 的节点处理能力。本节把流转换为 MediaStreamAudioSourceNode,接入一条不会回放到扬声器的音频图,并用轨道与上下文状态确认链路已经建立。
学习目标
- 使用
createMediaStreamSource()把麦克风MediaStream转成 Web Audio 输入节点 - 理解
MediaStream、MediaStreamAudioSourceNode与下游 AudioNode 的职责边界 - 验证输入链路并正确释放麦克风与
AudioContext
从媒体流进入音频图
getUserMedia() 返回的是浏览器媒体采集对象,而 Web Audio API 处理的是 AudioNode 图。audioContext.createMediaStreamSource(stream) 就是两者之间的适配入口:它读取流中的音频轨道,并把实时 PCM 音频送给后续节点。

不要为了“听见声音”就把麦克风直接连到 audioContext.destination。这样会把输入立即回放到扬声器,容易产生啸叫。需要实时监听时应使用耳机,并把监听作为显式功能设计。
建立一条可验证的输入链路
下面的代码可直接粘贴到 HTTPS 页面或 localhost 页面中的浏览器控制台。它动态创建按钮,点击后请求麦克风权限,把输入连接到 GainNode,再连接到 MediaStreamAudioDestinationNode。这个输出只存在于内存中的媒体流,不会自动播放到扬声器。
const startButton = document.createElement("button");
startButton.textContent = "接入麦克风";
document.body.appendChild(startButton);
let audioContext;
let micStream;
startButton.addEventListener("click", async () => {
micStream = await navigator.mediaDevices.getUserMedia({ audio: true });
audioContext = new AudioContext();
await audioContext.resume();
const source = audioContext.createMediaStreamSource(micStream);
const gain = audioContext.createGain();
const sink = audioContext.createMediaStreamDestination();
// 麦克风进入 Web Audio 图,再流向一个不会自动播放的内存输出。
source.connect(gain);
gain.connect(sink);
const inputTrack = micStream.getAudioTracks()[0];
const outputTrack = sink.stream.getAudioTracks()[0];
console.log("麦克风已接入音频图");
console.log("输入轨道状态:", inputTrack.readyState);
console.log("AudioContext 状态:", audioContext.state);
console.log("图内输出轨道数:", sink.stream.getAudioTracks().length);
console.log("输出轨道状态:", outputTrack.readyState);
startButton.disabled = true;
});预期输出
麦克风已接入音频图
输入轨道状态: live
AudioContext 状态: running
图内输出轨道数: 1
输出轨道状态: live首次运行时浏览器会请求麦克风权限。设备名、权限提示样式等由浏览器决定,但成功后输入轨道通常应为 live,上下文应为 running。
判断链路是否真的可用
先看 micStream.getAudioTracks() 是否至少有一条音频轨道;如果为空,说明拿到的流里没有麦克风音频。再看轨道的 readyState,live 表示轨道仍可产生数据,ended 表示设备已停止或轨道被关闭。
AudioContext.state 则反映 Web Audio 上下文是否在运行。若仍是 suspended,常见原因是浏览器的自动播放策略要求用户手势;把创建或 resume() 放进点击事件即可。
释放麦克风与音频上下文
页面不再使用麦克风时,要停止原始 MediaStream 的每条轨道,再关闭 AudioContext。仅断开某个 AudioNode 并不会保证摄像头或麦克风指示灯立即熄灭。
for (const track of micStream?.getTracks() ?? []) {
track.stop();
}
if (audioContext && audioContext.state !== "closed") {
await audioContext.close();
}
console.log("麦克风与 AudioContext 已释放");预期输出
麦克风与 AudioContext 已释放这时后续处理节点都应以 MediaStreamAudioSourceNode 为输入起点。是否再连接滤波器、增益、分析器或录制节点,取决于功能目标,而不是为了让麦克风“进入 Web Audio”而额外回放声音。