音频开发 / 系统课时

申请麦克风权限并取得 MediaStream

申请麦克风权限并取得 MediaStream

浏览器接入麦克风的核心入口是 navigator.mediaDevices.getUserMedia()。真正容易出错的不是调用本身,而是安全上下文、权限拒绝、没有可用设备或设备被系统占用等分支。本节把这些结果显式处理,并在成功后正确停止音轨释放麦克风。

学习目标

  • 在调用前确认页面满足麦克风 API 的基本运行条件。
  • 使用 getUserMedia() 获取只包含音频的 MediaStream。
  • 区分常见失败类型,并在不用时停止音轨释放设备。

调用前先检查环境

麦克风访问属于敏感能力,通常要求页面运行在安全上下文中,例如 HTTPS 或本机开发环境。代码还应确认 navigator.mediaDevices 与 getUserMedia 存在;如果这两个条件不满足,继续弹权限逻辑没有意义。

成功返回的 MediaStream 只是媒体流容器。后续无论要接入 AudioContext、录音还是 WebRTC,都应先从这个流开始,而不是直接访问某个“麦克风对象”。

权限结果不只有允许和拒绝

getUserMedia({ audio: true }) 返回 Promise。成功时得到 MediaStream;失败时会抛出 DOMException,其中 name 能帮助区分原因。常见情况包括 NotAllowedError、NotFoundError、NotReadableError 和约束无法满足时的 OverconstrainedError。

麦克风申请结果分支

不要根据错误消息文本做判断,因为不同浏览器的文案可能变化。业务逻辑应优先判断标准错误名,再把它映射为适合用户理解的提示。

完整获取与清理示例

下面代码可直接粘贴到 HTTPS 页面或本机开发页面的浏览器控制台。它创建“申请麦克风”和“停止麦克风”按钮,成功后保存流,失败时按错误名显示原因。

js
(() => {
  const requestButton = document.createElement("button");
  requestButton.textContent = "申请麦克风";

  const stopButton = document.createElement("button");
  stopButton.textContent = "停止麦克风";
  stopButton.disabled = true;

  const status = document.createElement("p");
  document.body.append(requestButton, stopButton, status);

  let stream = null;
  const reasonText = {
    NotAllowedError: "权限被拒绝或被浏览器策略阻止",
    NotFoundError: "没有找到可用麦克风",
    NotReadableError: "麦克风存在,但当前无法读取",
    OverconstrainedError: "请求的音频约束无法满足",
  };

  if (!window.isSecureContext || !navigator.mediaDevices?.getUserMedia) {
    requestButton.disabled = true;
    status.textContent = "当前页面不满足安全上下文或 API 可用性要求";
    return;
  }

  requestButton.addEventListener("click", async () => {
    try {
      stream = await navigator.mediaDevices.getUserMedia({
        audio: true,
        video: false,
      });

      const track = stream.getAudioTracks()[0];
      status.textContent = `已连接:${track?.label || "麦克风"}`;
      stopButton.disabled = false;
      console.log("已获取麦克风:", Boolean(track));
    } catch (error) {
      const reason = reasonText[error.name] ?? `获取失败:${error.name}`;
      status.textContent = reason;
      console.error(error);
    }
  });

  stopButton.addEventListener("click", () => {
    stream?.getTracks().forEach((track) => track.stop());
    stream = null;
    stopButton.disabled = true;
    status.textContent = "麦克风已停止";
  });
})();

预期输出

text
已获取麦克风: true

这条输出对应权限允许且浏览器成功提供音轨的情况。若用户拒绝权限、没有设备或设备暂不可读,页面状态文字会进入相应失败分支;控制台中的异常对象和消息由浏览器提供,实际值可能不同。

验证失败分支与释放行为

验证时不要只测“允许”路径。至少应在浏览器站点权限中重新设置麦克风权限,分别测试拒绝权限与允许权限;无麦克风或设备占用分支则只在实际环境具备条件时验证,不要为了测试而伪造异常对象。

成功拿到流后,观察浏览器的麦克风占用指示;点击“停止麦克风”后,所有音轨执行 stop(),占用状态应结束。只把 stream 变量设为 null 并不会自动关闭底层设备,真正释放资源的是停止其中的 MediaStreamTrack。

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

目录与阅读设置

阅读设置

17

记录一个想法

申请麦克风权限并取得 MediaStream

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

登录哪都通