# 音频路由 (/zh-CN/api-reference/rtc/ios/device-management/audio-route)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## isSpeakerphoneEnabled [#isspeakerphoneenabled]
检查是否启用扬声器播放音频。
```objc
- (BOOL)isSpeakerphoneEnabled NS_SWIFT_NAME(isSpeakerphoneEnabled());
```
### 调用时机 [#调用时机]
你可以在加入频道前或加入频道后调用该方法。
### 返回值 [#返回值]
- YES:(默认)已启用扬声器,音频将从扬声器播放。
- NO:未启用扬声器,音频将从非扬声器设备播放,例如耳机或听筒。
### 所属接口类 [#所属接口类]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)
## setDefaultAudioRouteToSpeakerphone: [#setdefaultaudioroutetospeakerphone]
设置默认音频播放路由。
```objc
- (int)setDefaultAudioRouteToSpeakerphone:(BOOL)defaultToSpeaker NS_SWIFT_NAME(setDefaultAudioRouteToSpeakerphone(_:));
```
大多数手机有两个音频路由:顶部的听筒和底部的扬声器。听筒音量较低,扬声器音量较高。你可以通过该方法设置在未连接外部音频设备时,音频是通过听筒还是扬声器播放。
在不同场景下,系统的默认音频路由如下:
- 语音通话:听筒。
- 音频直播:扬声器。
- 视频通话:扬声器。
- 视频直播:扬声器。
你可以调用该方法更改默认音频路由。
:::note
注: 调用此方法设置默认音频路由后,系统的实际音频路由会随着外部音频设备(有线耳机或蓝牙耳机)的连接而变化。
:::
### 调用时机 [#调用时机-1]
该方法需要在加入频道前调用。
### 参数 [#参数]
是否将扬声器设置为默认音频路由:
- YES:将扬声器设置为默认音频路由。
- NO:将听筒设置为默认音频路由。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)
## setEnableSpeakerphone: [#setenablespeakerphone]
设置是否将音频路由到扬声器。
```objc
- (int)setEnableSpeakerphone:(BOOL)enableSpeaker NS_SWIFT_NAME(setEnableSpeakerphone(_:));
```
你可以调用该方法切换当前频道中的音频路由,以满足不同的音频播放需求。
:::note
注:
- 该方法仅设置当前频道中的音频路由,不影响默认音频路由。如果你离开当前频道并加入另一个频道,将使用默认音频路由。
- 如果你使用了蓝牙或有线耳机等外部音频播放设备,该方法不生效。SDK 会通过外部设备播放音频。当你连接多个外部设备时,SDK 会通过最后连接的设备播放音频。
:::
### 适用场景 [#适用场景]
如果 SDK 的默认音频路由或 [setDefaultAudioRouteToSpeakerphone:](/zh-CN/api-reference/rtc/ios/device-management/audio-route#api_irtcengine_setdefaultaudioroutetospeakerphone) 的设置无法满足你的需求,可以调用该方法切换当前音频路由。
### 调用时机 [#调用时机-2]
请在加入频道后调用该方法。
### 参数 [#参数-1]
设置是否启用扬声器或听筒:
- YES:启用设备状态监测,音频路由为扬声器。
- NO:关闭设备状态监测,音频路由为听筒。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)
## rtcEngine\:didAudioRouteChanged: [#rtcenginedidaudioroutechanged]
本地音频路由发生变化时的回调。
```objc
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine didAudioRouteChanged:(AgoraAudioOutputRouting)routing NS_SWIFT_NAME(rtcEngine(_:didAudioRouteChanged:));
```
该回调在本地音频路由发生变化时触发,例如从听筒切换到扬声器。
### 触发时机 [#触发时机]
该回调在本地音频路由发生变化时被触发。
### 参数 [#参数-2]
[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) 实例。详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)。
当前的音频路由。详见 [AgoraAudioOutputRouting](/zh-CN/api-reference/rtc/ios/enum-audioroute)。
### 所属接口类 [#所属接口类-3]
- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineeventhandler)