流媒体与实时通信 / 系统课时

获取麦克风音频流

获取麦克风音频流

浏览器端实时语音的第一步,是用 navigator.mediaDevices.getUserMedia() 打开麦克风并拿到包含音频轨道的 MediaStream。这一节把权限、设备、基础约束和停止采集放在同一个可运行示例里,并给出最常见失败的判断方法。

学习目标

  • 使用 getUserMedia() 获取仅包含麦克风音频的 MediaStream。
  • 检查音频轨道的状态与实际生效设置。
  • 识别权限拒绝、无设备和约束不满足等常见失败。

调用前先满足浏览器条件

getUserMedia() 只在安全上下文中可用,生产页面应使用 HTTPS,本地开发通常可在 localhost 上测试。首次访问麦克风时,浏览器会请求用户授权;权限没有通过之前,不应假定设备标签或完整设备信息可见。

请求约束时,优先表达“希望浏览器启用什么”,不要一开始就用过多 exact 条件强制设备满足某个值。实时通话常见的基础音频约束是回声消除、降噪和自动增益,但浏览器最终是否支持及实际设置要以音轨的 getSettings() 为准。

获取并检查音频轨道

下面是一个可直接保存为 index.html 的完整示例。通过 HTTPS 或 http://localhost:<PORT> 打开页面,点击按钮后允许麦克风权限;停止按钮会主动关闭当前采集设备。

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

预期结果

text
点击“获取麦克风”并授权后,页面显示类似:
{
  "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,并继续分别验证发送、网络和远端播放链路。

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

目录与阅读设置

阅读设置

17

记录一个想法

获取麦克风音频流

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

登录哪都通