流媒体与实时通信 / 系统课时
获取麦克风音频流
获取麦克风音频流
浏览器端实时语音的第一步,是用 navigator.mediaDevices.getUserMedia() 打开麦克风并拿到包含音频轨道的 MediaStream。这一节把权限、设备、基础约束和停止采集放在同一个可运行示例里,并给出最常见失败的判断方法。
学习目标
- 使用
getUserMedia()获取仅包含麦克风音频的MediaStream。 - 检查音频轨道的状态与实际生效设置。
- 识别权限拒绝、无设备和约束不满足等常见失败。
调用前先满足浏览器条件
getUserMedia() 只在安全上下文中可用,生产页面应使用 HTTPS,本地开发通常可在 localhost 上测试。首次访问麦克风时,浏览器会请求用户授权;权限没有通过之前,不应假定设备标签或完整设备信息可见。
请求约束时,优先表达“希望浏览器启用什么”,不要一开始就用过多 exact 条件强制设备满足某个值。实时通话常见的基础音频约束是回声消除、降噪和自动增益,但浏览器最终是否支持及实际设置要以音轨的 getSettings() 为准。
获取并检查音频轨道
下面是一个可直接保存为 index.html 的完整示例。通过 HTTPS 或 http://localhost:<PORT> 打开页面,点击按钮后允许麦克风权限;停止按钮会主动关闭当前采集设备。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>getUserMedia audio demo</title>
</head>
<body>
<button id="start">获取麦克风</button>
<button id="stop" disabled>停止采集</button>
<pre id="status">尚未获取麦克风</pre>
<script>
const startButton = document.querySelector("#start");
const stopButton = document.querySelector("#stop");
const status = document.querySelector("#status");
let stream = null;
startButton.addEventListener("click", async () => {
try {
// 使用偏好约束请求采集,避免用 exact 过早排除可用设备。
stream = await navigator.mediaDevices.getUserMedia({
audio: {
echoCancellation: true,
noiseSuppression: true,
autoGainControl: true
},
video: false
});
const [track] = stream.getAudioTracks();
// 用实际轨道设置检查浏览器最终采用的设备参数。
const settings = track.getSettings();
status.textContent = JSON.stringify({
kind: track.kind,
enabled: track.enabled,
muted: track.muted,
readyState: track.readyState,
deviceId: settings.deviceId || null,
sampleRate: settings.sampleRate || null,
channelCount: settings.channelCount || null
}, null, 2);
startButton.disabled = true;
stopButton.disabled = false;
} catch (error) {
status.textContent = `${error.name}: ${error.message}`;
}
});
stopButton.addEventListener("click", () => {
if (!stream) return;
// stop() 会结束采集,并释放当前页面持有的音频轨道。
stream.getTracks().forEach((track) => track.stop());
stream = null;
status.textContent = "麦克风采集已停止";
startButton.disabled = false;
stopButton.disabled = true;
});
</script>
</body>
</html>预期结果
点击“获取麦克风”并授权后,页面显示类似:
{
"kind": "audio",
"enabled": true,
"muted": false,
"readyState": "live",
"deviceId": "<ID_OR_NULL>",
"sampleRate": <SAMPLE_RATE_OR_NULL>,
"channelCount": <CHANNEL_COUNT_OR_NULL>
}
点击“停止采集”后:
麦克风采集已停止<PORT>、<ID_OR_NULL>、采样率和通道数会因开发服务器、浏览器与设备而不同。示例没有把本地麦克风直接接到扬声器,避免调试时形成啸叫或回声。
约束与实际设置要分开看
传给 getUserMedia() 的对象是请求约束,不是最终设备参数。浏览器会结合权限、硬件能力和自身音频管线决定实际值,因此验证时应读取 track.getSettings(),而不是仅检查自己传入的对象。
例如,请求 echoCancellation: true 表示希望启用回声消除。对于必须满足的硬条件,才考虑 exact、min 或 max;条件过严可能导致 OverconstrainedError,让采集在开始前就失败。
常见失败按错误名定位
| 错误名或现象 | 常见原因 | 处理方向 |
|---|---|---|
navigator.mediaDevices 不可用 |
页面不是安全上下文或浏览器环境不支持 | 检查 HTTPS、localhost 与浏览器支持情况 |
NotAllowedError |
用户拒绝权限、系统禁止访问或 Permissions Policy 阻止 | 检查站点权限、系统权限和嵌入页面策略 |
NotFoundError |
没有可用的音频输入设备 | 检查麦克风是否存在、是否被系统禁用 |
NotReadableError |
设备存在但浏览器无法读取 | 检查操作系统占用、驱动或设备状态 |
OverconstrainedError |
强制约束无法被任何设备满足 | 放宽 exact、min、max 等条件 |
拿到 MediaStream 只表示采集阶段已经建立,不代表 WebRTC 连接已经发送音频。实际通话还需要把其中的音频轨道加入 RTCPeerConnection,并继续分别验证发送、网络和远端播放链路。