React Native集成Agora调用setEnableSpeakerphone耗时过长问题

确认受影响范围 #

• 依赖版本：react-native@0.61.5、react-native-agora@^3.4.6
• 可复现系统：Android 11，部分iOS设备

Android端排查与修复 #

你抓取的慢日志指向系统音频服务Binder调用阻塞，可按以下顺序排查：

• 排查音频抢占问题：Android 11对音频焦点管控更严格，若后台有其他应用持有音频焦点、或App自身同时存在多个音频流请求（比如同时播放通知音、其他媒体流），会导致IAudioService切换音频路由时阻塞。可以先在调用setEnableSpeakerphone前500ms停止所有非通话相关的音频播放，临时释放非必要音频焦点再测试耗时。
• 升级Agora SDK适配：react-native-agora@3.4.6对应的原生Agora SDK是3.4.6版本，该版本对Android 11的音频路由适配存在已知缺陷，优先将react-native-agora升级到^3.7.0及以上版本，官方已修复音频切换耗时的底层问题。
• 规避系统层面阻塞：部分定制ROM（小米、OPPO等品牌的Android 11版本）会对音频服务调用加额外校验，可在App的AndroidManifest.xml中添加音频相关权限的显式声明，确保权限全量获取：

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

  另外不要在UI主线程直接调用setEnableSpeakerphone，放到子线程执行避免阻塞UI，即使接口本身耗时也不会让用户感知到卡顿。

iOS端排查与修复 #

• 检查音频会话配置：iOS端出现该问题通常是AVAudioSession的category和mode配置和Agora SDK的设置冲突，调用setEnableSpeakerphone前，不要自行修改AVAudioSession的配置，交由Agora SDK统一管理音频会话，避免反复切换配置导致耗时增加。
• 升级SDK：和Android端一致，3.4.6版本的iOS原生SDK存在音频路由切换的偶现耗时问题，升级到3.7.0以上版本即可覆盖修复。

通用临时规避方案 #

如果暂时无法升级SDK，可以在触发切换扬声器/听筒操作时，先给用户一个操作反馈（比如按钮置灰、显示切换中提示），待接口回调返回后再恢复状态，降低用户对耗时的感知。

内容的提问来源于stack exchange，提问作者Syed Muhammad Yasir