iOS/Android设备连接蓝牙后无法接听Agora通话及音频录放问题咨询

iOS 平台处理步骤 #

• 验证蓝牙设备权限与配置
  前往「设置」→「蓝牙」，选中已连接的蓝牙设备，确认通话音频和媒体音频均已开启。同时检查App的麦克风权限是否启用：「设置」→「[你的App名称]」→「麦克风」设为开启状态。iOS 14+需确保App的Info.plist中添加了NSBluetoothAlwaysUsageDescription或NSBluetoothPeripheralUsageDescription权限描述。
• 强制Agora SDK路由到蓝牙设备
  初始化Agora引擎后，调用setEnableSpeakerphone(false)关闭扬声器，再通过setAudioRoute(AgoraAudioRouteBluetooth)强制音频路由到蓝牙设备。若通话过程中路由跳转，可在onAudioRouteChanged回调中重新设置蓝牙路由。
• 重置连接状态
  断开蓝牙设备，彻底关闭Agora App，重启手机蓝牙后重新配对设备，再打开App测试。

Android 平台处理步骤 #

• 确认蓝牙权限与设备协议
  确保App已申请对应蓝牙权限：Android 11及以下需BLUETOOTH、BLUETOOTH_ADMIN；Android 12+需BLUETOOTH_CONNECT、BLUETOOTH_SCAN。同时验证蓝牙设备支持HFP协议（双向音频），仅支持A2DP的媒体扬声器无法实现录制功能。
• 手动配置Agora音频路由
  初始化引擎时调用setDefaultAudioRouteToSpeakerphone(false)，再执行setAudioRoute(AgoraAudioRoute.BLUETOOTH)锁定蓝牙路由。若自动路由失效，可在通话开始后手动触发路由切换。
• 清除蓝牙配对缓存
  前往「设置」→「蓝牙」，长按已连接设备选择「取消配对」，重新配对后再次测试Agora音视频功能。

针对具体问题的补充方案 #

1. 蓝牙耳机无法接听Agora通话 #

• 检查耳机是否处于通话模式：部分蓝牙耳机需手动切换到通话模式（可通过耳机按键或App设置），确保手机蓝牙设置中「通话音频」已开启。
• 若App内置音频设置，通话过程中手动选择蓝牙设备作为音频输出源。

2. 蓝牙扬声器无法录制与播放 #

• 播放问题：确认系统默认音频输出已设为蓝牙扬声器，Agora SDK未强制切换到听筒/手机扬声器。
• 录制问题：若扬声器仅支持A2DP协议（仅媒体播放），无法实现音频输入，需更换支持HFP协议的双向蓝牙设备。

内容的提问来源于stack exchange，提问作者meherdeep thakur