# 听声辨位 (/zh-CN/api-reference/rtc/android/audio/audio-prenpost/sound-position) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## enableSoundPositionIndication [#enablesoundpositionindication] 启用或关闭远端用户的立体声声像功能。 ```java public abstract int enableSoundPositionIndication(boolean enabled); ``` 请在加入频道前调用该方法。启用后,本地用户可以通过调用 [setRemoteVoicePosition](/zh-CN/api-reference/rtc/android/audio/audio-prenpost/sound-position#api_irtcengine_setremotevoiceposition) 跟踪远端用户的位置。 ### 参数 [#参数] 是否启用远端用户的立体声声像功能: - true:启用立体声声像。 - false:关闭立体声声像。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## setRemoteVoicePosition [#setremotevoiceposition] 设置远端用户语音的二维位置和音量。 ```java public abstract int setRemoteVoicePosition(int uid, double pan, double gain); ``` 该方法通过左右声道的声音差异设置远端用户的语音位置和音量,使本地用户可以更容易地识别远端用户的位置,从而营造空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。 :::note 注: - 要使该方法生效,请在加入频道前调用 [enableSoundPositionIndication](/zh-CN/api-reference/rtc/android/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] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## setRemoteVoicePositionEx [#setremotevoicepositionex] 设置远端用户语音的二维位置和音量。 ```java public abstract int setRemoteVoicePositionEx(int uid, double pan, double gain, RtcConnection connection); ``` 该方法用于设置远端用户的语音位置和音量。调用该方法后,左右声道的声音差异可以让你实时感知远端用户的位置,从而营造空间感。该方法适用于大型多人在线游戏,例如大逃杀类游戏。 :::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/android/class-rtcconnection)。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [RtcEngineEx](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengineex)