React Native中如何强制将音频输出从耳机切换至听筒？

使用第三方库（推荐方案） #

react-native-incall-manager是专门处理通话音频路由的库，可直接实现强制切换到听筒的需求：

1. 安装依赖

npm install react-native-incall-manager --save
# 或 yarn add react-native-incall-manager

RN 0.60+版本会自动完成链接，低版本需手动执行react-native link react-native-incall-manager。

2. 调用切换逻辑

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

// 初始化音频会话并强制切换到听筒
InCallManager.start({
  media: 'audio',
  auto: false, // 禁用自动路由逻辑
  speaker: false, // false表示使用听筒，true则切换到扬声器
});

// 后续恢复默认路由的方法
// InCallManager.setSpeakerphoneOn(true); // 切到扬声器
// InCallManager.stop(); // 结束音频会话管理，恢复系统默认路由

3. 权限配置

• iOS：在Info.plist中添加麦克风权限声明

<key>NSMicrophoneUsageDescription</key>
<string>需要使用麦克风进行音频相关操作</string>

• Android：在AndroidManifest.xml中添加权限

<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

自定义原生模块实现 #

如果第三方库无法满足需求，可自行封装原生模块：

iOS端（基于AVAudioSession） #

#import <AVFoundation/AVFoundation.h>

- (void)forceRouteToReceiver {
    NSError *error;
    AVAudioSession *session = [AVAudioSession sharedInstance];
    
    // 设置音频类别为播放录制模式，允许蓝牙但优先听筒
    [session setCategory:AVAudioSessionCategoryPlayAndRecord
              withOptions:AVAudioSessionCategoryOptionAllowBluetooth | AVAudioSessionCategoryOptionDefaultToSpeaker
                    error:&error];
    
    if (!error) {
        // 强制覆盖音频路由到听筒
        [session overrideOutputAudioPort:AVAudioSessionPortOverrideNone error:&error];
        [session setActive:YES error:&error];
    }
}

Android端（基于AudioManager） #

import android.content.Context;
import android.media.AudioManager;

public void forceRouteToReceiver(Context context) {
    AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
    // 设置为通话模式
    audioManager.setMode(AudioManager.MODE_IN_COMMUNICATION);
    // 关闭扬声器，强制使用听筒
    audioManager.setSpeakerphoneOn(false);
}

将上述原生方法封装为React Native模块后，即可在JS端调用。

关键注意事项 #

• 音频路由切换需要音频会话处于活跃状态，需确保提前初始化音频播放/录制功能。
• iOS中，AVAudioSessionCategoryOptionDefaultToSpeaker结合overrideOutputAudioPort可确保耳机连接时仍强制使用听筒。
• Android中，MODE_IN_COMMUNICATION模式会自动优先听筒，关闭扬声器即可完成强制切换。

内容的提问来源于stack exchange，提问作者Omar Zaoujal