# 听声辨位 (/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-prenpost/sound-position)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## enableSoundPositionIndication [#enablesoundpositionindication]
启用或关闭远端用户的立体声声像功能。
```cpp
virtual int enableSoundPositionIndication(bool enabled) = 0;
```
请确保在加入频道前调用该方法。本地用户随后可以调用 [setRemoteVoicePosition](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-prenpost/sound-position#api_irtcengine_setremotevoiceposition) 跟踪远端用户的位置。
### 参数 [#参数]
是否启用远端用户的立体声声像功能:
- true:启用立体声声像。
- false:关闭立体声声像。
### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## setRemoteVoicePosition [#setremotevoiceposition]
设置远端用户语音在水平面上的位置和音量。
```cpp
virtual int setRemoteVoicePosition(uid_t uid, double pan, double gain) = 0;
```
该方法设置远端用户的二维位置和音量,帮助你更清晰地听到并识别远端用户的位置。通过左右声道的声音差异,你可以实时感知远端用户的方位,从而营造空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。
:::note
注:
- 要使该方法生效,请在加入频道前调用 [enableSoundPositionIndication](/zh-CN/api-reference/rtc/cpp-all-platforms/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]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## setRemoteVoicePositionEx [#setremotevoicepositionex]
设置远端用户语音的二维位置和音量。
```cpp
virtual int setRemoteVoicePositionEx(uid_t uid, double pan, double gain, const RtcConnection& connection) = 0;
```
声网通过左右声道的声音差异,让你能够实时感知远端用户的位置,从而营造空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。
:::note
注:
- 为获得最佳语音定位效果,声网建议使用有线耳机。
- 请在加入频道后调用该方法。
:::
### 适用场景 [#适用场景]
该方法适用于多频道场景。
### 参数 [#参数-2]
远端用户 ID。
远端用户的语音位置,取值范围为 -1.0 到 1.0:
- -1.0:远端语音来自左侧。
- 0.0:(默认)远端语音来自正前方。
- 1.0:远端语音来自右侧。
远端用户的音量,取值范围为 0.0 到 100.0。默认值为 100.0(远端用户的原始音量)。数值越小,音量越低。
连接信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/cpp-all-platforms/class-rtcconnection)。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [IRtcEngineEx](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineex)