# 听声辨位 (/zh-CN/api-reference/rtc/macos/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/macos/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/macos/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/macos/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/macos/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/macos/class-rtcconnection)。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)