React-native-webrtc应用未优先使用连接的蓝牙麦克风问题排查

阿华AIGC实验室

2026-6-13

iOS端优先使用蓝牙音频设备解决方案（基于react-native-webrtc）

问题根源

这个问题和react-native-webrtc直接相关——iOS的音频会话机制比Android更严格，react-native-webrtc依赖系统音频会话选择输入输出设备，默认配置下不会自动切换到蓝牙设备，需要额外调整。

具体解决步骤

1. 完善react-native-incall-manager的iOS配置

Android端生效是因为incall-manager默认适配了Android的音频路由，但iOS需要明确指定蓝牙权限和会话模式：

import InCallManager from 'react-native-incall-manager';

// 通话开始时初始化音频会话
InCallManager.start({
  media: 'audio',
  auto: true,
  ios: {
    category: 'playAndRecord', // 必须设置为playAndRecord才能支持输入输出
    mode: 'voiceChat', // 适配语音通话场景
    options: [
      'allowBluetooth', // 允许蓝牙设备
      'allowBluetoothA2DP',
      'mixWithOthers' // 根据需求选择，避免和其他应用音频冲突
    ]
  }
});

2. 监听蓝牙设备连接事件并手动切换

iOS不会自动触发音频路由切换，需要监听设备变化事件，主动切换到蓝牙：

// 监听音频设备变更
InCallManager.addEventListener('audioDeviceChanged', (data) => {
  // 当检测到蓝牙设备时，强制切换
  if (data.device === 'bluetooth') {
    InCallManager.setAudioDevice('bluetooth');
  }
});

// 通话结束后移除监听
InCallManager.removeEventListener('audioDeviceChanged');

3. 调整react-native-webrtc的媒体约束

避免在getUserMedia时强制指定固定设备ID，让系统自动选择可用的蓝牙设备：

const audioConstraints = {
  audio: {
    echoCancellation: true,
    noiseSuppression: true,
    // 不要设置deviceId: { exact: 'xxx' }，否则会锁定到固定设备
  }
};

// 获取媒体流时使用宽松约束
navigator.mediaDevices.getUserMedia(audioConstraints)
  .then(stream => {
    // 将流用于WebRTC通话
  })
  .catch(err => console.error('获取音频流失败:', err));

4. 配置iOS权限

在Info.plist中添加必要权限，确保应用能访问蓝牙和麦克风：

<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风进行语音通话</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要访问蓝牙设备进行语音通话</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>需要访问蓝牙外设进行语音通话</string>