React Native如何检测音频输出设备（耳机/内置扬声器）及权限说明

核心实现思路 #

React Native 核心API未直接提供音频输出设备检测能力，需依赖第三方库或自定义原生模块实现，以下是具体方案：

方式一：使用第三方库（推荐） #

以 react-native-audio-device-info 为例，该库封装了原生设备检测逻辑：

1. 安装依赖

npm install react-native-audio-device-info --save
# 或使用 yarn
yarn add react-native-audio-device-info

RN 0.60+ 版本支持自动链接，低于此版本需手动执行 react-native link 完成原生模块关联。

2. 检测与监听设备状态

import AudioDeviceInfo from 'react-native-audio-device-info';

// 获取当前音频输出设备
const getCurrentAudioDevice = async () => {
  try {
    const deviceType = await AudioDeviceInfo.getAudioOutputDevice();
    // 返回值包含 'headphones'、'speaker'、'bluetooth' 等类型
    switch(deviceType) {
      case 'headphones':
        console.log('当前通过有线耳机播放');
        break;
      case 'speaker':
        console.log('当前通过内置扬声器播放');
        break;
      case 'bluetooth':
        console.log('当前通过蓝牙设备播放');
        break;
      default:
        console.log('未知输出设备');
    }
  } catch (error) {
    console.error('获取音频设备失败:', error);
  }
};

// 监听设备切换事件
AudioDeviceInfo.addAudioDeviceChangeListener((deviceType) => {
  console.log('音频输出设备切换为:', deviceType);
});

方式二：自定义原生模块（深度定制场景） #

若第三方库无法满足需求，可自行封装原生代码：

iOS 端

利用 AVAudioSession 监听音频路由变化：

#import <AVFoundation/AVFoundation.h>

// 注册路由变化监听
- (void)setupAudioListener {
  [[NSNotificationCenter defaultCenter] addObserver:self
                                           selector:@selector(audioRouteChanged:)
                                               name:AVAudioSessionRouteChangeNotification
                                             object:[AVAudioSession sharedInstance]];
}

// 处理路由变化事件
- (void)audioRouteChanged:(NSNotification *)notification {
  AVAudioSessionRouteDescription *currentRoute = [[AVAudioSession sharedInstance] currentRoute];
  for (AVAudioSessionPortDescription *port in currentRoute.outputs) {
    NSString *deviceType;
    if ([port.portType isEqualToString:AVAudioSessionPortHeadphones]) {
      deviceType = @"headphones";
    } else if ([port.portType isEqualToString:AVAudioSessionPortBuiltInSpeaker]) {
      deviceType = @"speaker";
    } else if ([port.portType isEqualToString:AVAudioSessionPortBluetoothA2DP] || 
               [port.portType isEqualToString:AVAudioSessionPortBluetoothHFP]) {
      deviceType = @"bluetooth";
    } else {
      deviceType = @"unknown";
    }
    // 发送事件到JS层
    [self sendEventWithName:@"AudioDeviceChanged" body:@{@"deviceType": deviceType}];
  }
}

Android 端

通过广播接收器监听音频设备状态：

private BroadcastReceiver audioDeviceReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (AudioManager.ACTION_HEADSET_PLUG.equals(action)) {
            int state = intent.getIntExtra("state", -1);
            String deviceType = state == 1 ? "headphones" : "speaker";
            sendEvent("AudioDeviceChanged", deviceType);
        } else if (BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED.equals(action)) {
            int state = intent.getIntExtra(BluetoothA2dp.EXTRA_STATE, BluetoothA2dp.STATE_DISCONNECTED);
            AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
            if (state == BluetoothA2dp.STATE_CONNECTED) {
                sendEvent("AudioDeviceChanged", "bluetooth");
            } else if (state == BluetoothA2dp.STATE_DISCONNECTED) {
                String fallbackDevice = audioManager.isWiredHeadsetOn() ? "headphones" : "speaker";
                sendEvent("AudioDeviceChanged", fallbackDevice);
            }
        }
    }
};

// 初始化时注册广播
@Override
public void initialize(ReactApplicationContext reactContext) {
    super.initialize(reactContext);
    IntentFilter filter = new IntentFilter();
    filter.addAction(AudioManager.ACTION_HEADSET_PLUG);
    filter.addAction(BluetoothA2dp.ACTION_CONNECTION_STATE_CHANGED);
    reactContext.registerReceiver(audioDeviceReceiver, filter);
}

权限说明 #

• iOS：无需额外权限，AVAudioSession 属于系统核心音频API，默认允许访问。
• Android：
  • 有线耳机检测：无需特殊权限，系统广播可直接接收。
  • 蓝牙设备检测：需在 AndroidManifest.xml 中添加权限：

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <!-- Android 12+ 需新增 -->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    

    Android 6.0+ 蓝牙权限属于正常权限，无需动态申请；Android 12+ 的 BLUETOOTH_CONNECT 需要动态申请。

注意事项 #

• 部分蓝牙设备（如蓝牙音箱）连接后，iOS与Android的路由检测逻辑存在细微差异，需覆盖测试。
• 后台状态下，系统可能限制广播或通知接收，若需后台监听，iOS需开启音频后台模式，Android需申请后台权限。

内容的提问来源于stack exchange，提问作者mostafa faryabi