音频路由
- C++
更新时间不可用
isSpeakerphoneEnabled
检查扬声器是否启用。
virtual bool isSpeakerphoneEnabled() = 0;注： 该方法仅适用于 Android 和 iOS 平台。
调用时机
你可以在加入频道前或加入频道后调用该方法。
返回值
- true：扬声器已启用，音频将从扬声器播放。
- false：扬声器未启用，音频将从其他设备播放，例如耳机或听筒。
所属接口类
setDefaultAudioRouteToSpeakerphone
设置默认音频播放路由。
virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0;大多数手机有两个音频路由：顶部的听筒和底部的扬声器。听筒音量较低，扬声器音量较高。你可以通过该方法设置在未连接外部音频设备时，默认使用听筒或扬声器播放音频。 不同场景下系统的默认音频路由如下：
- 语音通话：听筒。
- 音频直播：扬声器。
- 视频通话：扬声器。
- 视频直播：扬声器。
注： 该方法仅适用于 Android 和 iOS 平台。
调用时机
在加入频道前调用此方法。如果需要在加入频道后更改音频路由，请调用 setEnableSpeakerphone。
相关回调
成功调用该方法后，SDK 会触发 onAudioRoutingChanged 回调报告当前的音频路由。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setEnableSpeakerphone
设置是否将音频路由切换为扬声器。
virtual int setEnableSpeakerphone(bool speakerOn) = 0;注： setEnableSpeakerphone 仅设置当前频道中的音频路由，不影响默认音频路由。如果用户离开当前频道并加入另一个频道，将使用默认音频路由。 如果用户使用蓝牙或有线耳机等外部音频播放设备，该方法不生效，SDK 会通过外部设备播放音频。当用户连接多个外部设备时，SDK 会通过最后连接的设备播放音频。 该方法仅适用于 Android 和 iOS 平台。
适用场景
如果 SDK 的默认音频路由或 setDefaultAudioRouteToSpeakerphone 的设置无法满足你的需求，可以调用该方法切换当前音频路由。
调用时机
请在加入频道后调用该方法。
相关回调
成功调用该方法后，SDK 会触发 onAudioRoutingChanged 回调报告当前音频路由。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setRouteInCommunicationMode
设置通信音频模式下的音频播放路由。
virtual int setRouteInCommunicationMode(int route) = 0;注： 同时使用该方法和 setEnableSpeakerphone 方法可能会导致冲突。建议你仅使用 setRouteInCommunicationMode 方法。该方法仅适用于 Android 平台。
调用时机
该方法可以在加入频道前或加入频道后调用。
相关回调
成功调用该方法后，SDK 会触发 onAudioRoutingChanged 回调报告当前的音频路由。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
onAudioRoutingChanged
本地音频路由发生变化时触发的回调。
virtual void onAudioRoutingChanged(int routing) { (void)routing; }注： 该回调仅适用于 Android、iOS 和 macOS 平台。
参数
| 参数名 | 描述 |
|---|---|
routing | 当前的音频路由，详见 AudioRoute。 |