功能变更日志
  1. 自客户端 SDK v3.38,支持本功能。
  2. 自客户端 SDK v3.42,功能优化。setDefaultAudioRoute 选择设备的听筒或扬声器作为默认音频路由。setAudioRoute 支持更多音频设备类型,例如有线耳机、蓝牙耳机等,但只支持在 AUDIO_SCENARIO_COMMUNICATION 通话场景下调用生效。
  3. 自客户端 SDK v3.50,功能优化。支持撤销 setAudioRoute 的效果,回归通过 setDefaultAudioRoute 设定的默认音频路由设备。
功能简介

本文以安卓端接口名称为例。

音频路由指的是安装在设备上的 App 用于播放音频的设备。主要有以下两种:

切换默认音频路由和接入外接设备时的路由切换行为

RTC SDK 内置了默认音频路由判定和切换策略。策略如下:

通过 setDefaultAudioRoute 指定默认音频路由(扬声器/听筒)和 SDK 默认的插拔外设时的音频路由切换策略,已能支持绝大多数场景需求。

手动切换音频路由

如果以上默认的音频路由判定和切换策略不能满足你的场景需求,特别在接入外接设备时,需要将音频路由强制切换到扬声器或听筒等其他路由,参考以下用法:

  1. 调用 setAudioRoute 将当前音频路由切换到指定设备。
  2. 成功切换音频路由后,将触发 onAudioRouteChanged 回调提示音频路由更改。

注意:

API 参考
AndroidiOS
设置默认音频路由setDefaultAudioRoutesetDefaultAudioRoute:
强制切换音频路由setAudioRoutesetAudioRoute:
获取当前的音频路由getAudioRoutegetAudioRoute