Chrome扩展Manifest V3如何获取浏览器全局麦克风权限？

1. 配置manifest.json权限 #

Manifest V3要求明确声明媒体捕获权限，需在配置文件中添加对应权限项：

• 加入"audioCapture"权限（Manifest V3专用的音频捕获权限）
• 若需全局访问麦克风，可搭配"activeTab"或<all_urls>权限（根据需求选择，<all_urls>对应全局范围）

示例manifest.json：

{
  "manifest_version": 3,
  "name": "你的扩展名称",
  "version": "1.0",
  "permissions": ["audioCapture", "activeTab"],
  "action": {
    "default_popup": "popup.html"
  }
}

2. 绑定用户交互触发权限请求 #

Chrome禁止自动触发媒体权限弹窗，必须将权限请求绑定到用户主动操作（比如按钮点击），不能在popup加载时直接调用请求代码。

修改后的popup.js：

// 给按钮绑定点击事件，触发麦克风权限请求
document.getElementById("micBtn").addEventListener("click", getLocalStream);

function getLocalStream() {
  navigator.mediaDevices
    .getUserMedia({ video: false, audio: true })
    .then((stream) => {
      window.localStream = stream;
      // 关联到popup中的audio元素
      const localAudio = document.getElementById("localAudio");
      localAudio.srcObject = stream;
      localAudio.autoplay = true;
    })
    .catch((err) => {
      console.error(`错误：${err}`);
    });
}

对应的popup.html需添加触发按钮：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>麦克风权限测试</title>
</head>
<body>
  <button id="micBtn">开启麦克风</button>
  <audio id="localAudio"></audio>
  <script src="popup.js"></script>
</body>
</html>

3. 常见问题排查 #

• 若仍出现权限拒绝，检查Chrome扩展权限设置：进入chrome://extensions/，找到目标扩展点击「详细信息」，确认「麦克风」权限已开启。
• 避免在隐身模式下测试（除非已允许扩展在隐身模式运行），该模式下权限规则更严格。
• Manifest V3中navigator.mediaDevices在popup环境可用，但必须同时满足用户交互触发和权限配置完整两个条件。

内容的提问来源于stack exchange，提问作者Samridhi Kumari