# 听声辨位 (/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## enableSoundPositionIndication: [#enablesoundpositionindication]
启用或关闭远端用户的立体声声像功能。
```objc
- (int)enableSoundPositionIndication:(BOOL)enabled NS_SWIFT_NAME(enableSoundPositionIndication(_:));
```
请确保在加入频道前调用该方法,从而使你可以通过调用 [setRemoteVoicePosition\:pan\:gain:](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position#api_irtcengine_setremotevoiceposition) 跟踪远端用户的位置。
### 参数 [#参数]
是否启用远端用户的立体声声像功能:
- YES:启用立体声声像。
- NO:关闭立体声声像。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)
## setRemoteVoicePosition\:pan\:gain: [#setremotevoicepositionpangain]
设置远端用户语音的二维位置和音量。
```objc
- (int)setRemoteVoicePosition:(NSUInteger)uid pan:(double)pan gain:(double)gain NS_SWIFT_NAME(setRemoteVoicePosition(_:pan:gain:));
```
该方法设置远端用户的二维位置和音量,使你可以更容易地听到并识别远端用户的位置。通过左右声道的声音差异,你可以实时追踪远端用户的位置,从而营造空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。
:::note
注:
- 要使该方法生效,请在加入频道前调用 [enableSoundPositionIndication:](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position#api_irtcengine_enablesoundpositionindication) 方法为远端用户开启立体声声道。
- 为获得最佳语音定位效果,声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
:::
### 参数 [#参数-1]
远端用户的用户 ID。
远端用户的语音位置。取值范围为 -1.0 到 1.0:
- 0.0:(默认)远端语音来自正前方。
- -1.0:远端语音来自左侧。
- 1.0:远端语音来自右侧。
远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0(远端用户的原始音量)。数值越小,音量越低。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)
## setRemoteVoicePositionEx\:pan\:gain\:connection: [#setremotevoicepositionexpangainconnection]
设置远端用户语音的二维位置和音量。
```objc
- (int)setRemoteVoicePositionEx:(NSUInteger)uid
pan:(double)pan
gain:(double)gain
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setRemoteVoicePositionEx(_:pan:gain:connection:));
```
你可以使用该方法设置远端用户的语音位置和音量。调用该方法设置远端用户的语音位置后,左右声道的声音差异可以帮助你实时感知远端用户的位置,增强空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。
:::note
注:
- 为获得最佳语音定位效果,声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
:::
### 适用场景 [#适用场景]
该方法适用于多频道场景。
### 参数 [#参数-2]
远端用户的用户 ID。
远端用户的语音位置。取值范围为 -1.0 到 1.0:
- -1.0:远端语音来自左侧。
- 0.0(默认):远端语音来自正前方。
- 1.0:远端语音来自右侧。
远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0(远端用户的原始音量)。值越小,音量越低。
连接信息,详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/ios/class-rtcconnection)。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineex)