# 音频路由 (/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## isSpeakerphoneEnabled [#isspeakerphoneenabled] 检查扬声器是否启用。 ```cpp virtual bool isSpeakerphoneEnabled() = 0; ``` :::note 注: 该方法仅适用于 Android 和 iOS 平台。 ::: ### 调用时机 [#调用时机] 你可以在加入频道前或加入频道后调用该方法。 ### 返回值 [#返回值] - true:扬声器已启用,音频将从扬声器播放。 - false:扬声器未启用,音频将从其他设备播放,例如耳机或听筒。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setDefaultAudioRouteToSpeakerphone [#setdefaultaudioroutetospeakerphone] 设置默认音频播放路由。 ```cpp virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; ``` 大多数手机有两个音频路由:顶部的听筒和底部的扬声器。听筒音量较低,扬声器音量较高。你可以通过该方法设置在未连接外部音频设备时,默认使用听筒或扬声器播放音频。 不同场景下系统的默认音频路由如下: - 语音通话:听筒。 - 音频直播:扬声器。 - 视频通话:扬声器。 - 视频直播:扬声器。 :::note 注: 该方法仅适用于 Android 和 iOS 平台。 ::: ### 调用时机 [#调用时机-1] 在加入频道前调用此方法。如果需要在加入频道后更改音频路由,请调用 [setEnableSpeakerphone](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#api_irtcengine_setenablespeakerphone)。 ### 相关回调 [#相关回调] 成功调用该方法后,SDK 会触发 [onAudioRoutingChanged](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#callback_irtcengineeventhandler_onaudioroutingchanged) 回调报告当前的音频路由。 ### 参数 [#参数] 是否将扬声器设置为默认音频路由: - true:将扬声器设置为默认音频路由。 - false:将听筒设置为默认音频路由。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setEnableSpeakerphone [#setenablespeakerphone] 设置是否将音频路由切换为扬声器。 ```cpp virtual int setEnableSpeakerphone(bool speakerOn) = 0; ``` :::note 注: [setEnableSpeakerphone](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#api_irtcengine_setenablespeakerphone) 仅设置当前频道中的音频路由,不影响默认音频路由。如果用户离开当前频道并加入另一个频道,将使用默认音频路由。 如果用户使用蓝牙或有线耳机等外部音频播放设备,该方法不生效,SDK 会通过外部设备播放音频。当用户连接多个外部设备时,SDK 会通过最后连接的设备播放音频。 该方法仅适用于 Android 和 iOS 平台。 ::: ### 适用场景 [#适用场景] 如果 SDK 的默认音频路由或 [setDefaultAudioRouteToSpeakerphone](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#api_irtcengine_setdefaultaudioroutetospeakerphone) 的设置无法满足你的需求,可以调用该方法切换当前音频路由。 ### 调用时机 [#调用时机-2] 请在加入频道后调用该方法。 ### 相关回调 [#相关回调-1] 成功调用该方法后,SDK 会触发 [onAudioRoutingChanged](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#callback_irtcengineeventhandler_onaudioroutingchanged) 回调报告当前音频路由。 ### 参数 [#参数-1] 是否启用扬声器: - true:启用设备状态监测,音频路由为扬声器。 - false:禁用设备状态监测,音频路由为听筒。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## setRouteInCommunicationMode [#setrouteincommunicationmode] 设置通信音频模式下的音频播放路由。 ```cpp virtual int setRouteInCommunicationMode(int route) = 0; ``` :::note 注: 同时使用该方法和 [setEnableSpeakerphone](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#api_irtcengine_setenablespeakerphone) 方法可能会导致冲突。建议你仅使用 [setRouteInCommunicationMode](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#api_irtcengine_setrouteincommunicationmode) 方法。该方法仅适用于 Android 平台。 ::: ### 调用时机 [#调用时机-3] 该方法可以在加入频道前或加入频道后调用。 ### 相关回调 [#相关回调-2] 成功调用该方法后,SDK 会触发 [onAudioRoutingChanged](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/audio-route#callback_irtcengineeventhandler_onaudioroutingchanged) 回调报告当前的音频路由。 ### 参数 [#参数-2] 你希望使用的音频播放路由: - `-1`:默认音频路由。 - `0`:带麦克风的耳机。 - `1`:听筒。 - `2`:不带麦克风的耳机。 - `3`:设备内置扬声器。 - `4`:(尚不支持)外部扬声器。 - `5`:蓝牙耳机。 - `6`:USB 设备。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine) ## onAudioRoutingChanged [#onaudioroutingchanged] 本地音频路由发生变化时触发的回调。 ```cpp virtual void onAudioRoutingChanged(int routing) { (void)routing; } ``` :::note 注: 该回调仅适用于 Android、iOS 和 macOS 平台。 ::: ### 参数 [#参数-3] 当前的音频路由,详见 [AudioRoute](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-audioroute)。 ### 所属接口类 [#所属接口类-4] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineeventhandler)