音频路由指的是用于播放音频的设备。

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

当接入外接设备时,RTC 将播放设备更新为最近接入的设备。当同时连接多个音频播放设备时,将通过最后一个接入的设备播放。
没有外接设备时,系统将选取默认音频路由作为播放设备。默认音频路由可以通过调用 setDefaultAudioRoute 进行指定。当无外接设备时,音频路由将立即切换

手动切换音频路由

如果你需要将音频路由切换到指定设备:

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

注意事项如下:

常见问题

Q: 当前音频路由设备断开后,音频路由如何切换?
A:
当前音频路由设备断开后,SDK 将按照设备接入顺序,选取最后接入的设备作为音频路由。当外接设备时,选取默认音频路由。
通过监听onAudioRouteChanged 回调,在音频路由发生自动切换/手动切换时,获取当前的音频路由设备信息。

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