# 听声辨位 (/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="toc_sound_position"></a>

<a id="api_irtcengine_enablesoundpositionindication"></a>

<a id="ariaid-title2"></a>

## enableSoundPositionIndication: [#enablesoundpositionindication]

启用或关闭远端用户的立体声声像功能。

<a id="api_irtcengine_enablesoundpositionindication__prototype"></a>

```objc
- (int)enableSoundPositionIndication:(BOOL)enabled NS_SWIFT_NAME(enableSoundPositionIndication(_:));
```

<a id="api_irtcengine_enablesoundpositionindication__detailed_desc"></a>

请确保在加入频道前调用该方法，从而使你可以通过调用 [setRemoteVoicePosition\:pan\:gain:](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position#api_irtcengine_setremotevoiceposition) 跟踪远端用户的位置。

<a id="api_irtcengine_enablesoundpositionindication__parameters"></a>

### 参数 [#参数]

<ParameterList>
<a id="enabled"></a>
<Parameter name="enabled">

是否启用远端用户的立体声声像功能：

- YES：启用立体声声像。
- NO：关闭立体声声像。

</Parameter>
</ParameterList>

<a id="api_irtcengine_enablesoundpositionindication__return_values"></a>

### 返回值 [#返回值]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setremotevoiceposition"></a>

<a id="ariaid-title3"></a>

## setRemoteVoicePosition\:pan\:gain: [#setremotevoicepositionpangain]

设置远端用户语音的二维位置和音量。

<a id="api_irtcengine_setremotevoiceposition__prototype"></a>

```objc
- (int)setRemoteVoicePosition:(NSUInteger)uid pan:(double)pan gain:(double)gain NS_SWIFT_NAME(setRemoteVoicePosition(_:pan:gain:));
```

<a id="api_irtcengine_setremotevoiceposition__detailed_desc"></a>

该方法设置远端用户的二维位置和音量，使你可以更容易地听到并识别远端用户的位置。通过左右声道的声音差异，你可以实时追踪远端用户的位置，从而营造空间感。该方法适用于大型多人在线游戏，例如大逃杀类游戏。

:::note
注：

- 要使该方法生效，请在加入频道前调用 [enableSoundPositionIndication:](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/sound-position#api_irtcengine_enablesoundpositionindication) 方法为远端用户开启立体声声道。
- 为获得最佳语音定位效果，声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
:::

<a id="api_irtcengine_setremotevoiceposition__parameters"></a>

### 参数 [#参数-1]

<ParameterList>
<a id="uid"></a>
<Parameter name="uid">

远端用户的用户 ID。

</Parameter>
<a id="pan"></a>
<Parameter name="pan">

远端用户的语音位置。取值范围为 -1.0 到 1.0：

- 0.0：（默认）远端语音来自正前方。
- -1.0：远端语音来自左侧。
- 1.0：远端语音来自右侧。

</Parameter>
<a id="gain"></a>
<Parameter name="gain">

远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0（远端用户的原始音量）。数值越小，音量越低。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setremotevoiceposition__return_values"></a>

### 返回值 [#返回值-1]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-1]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengineex_setremotevoicepositionex"></a>

<a id="ariaid-title4"></a>

## setRemoteVoicePositionEx\:pan\:gain\:connection: [#setremotevoicepositionexpangainconnection]

设置远端用户语音的二维位置和音量。

<a id="api_irtcengineex_setremotevoicepositionex__prototype"></a>

```objc
- (int)setRemoteVoicePositionEx:(NSUInteger)uid
                          pan:(double)pan
                         gain:(double)gain
                   connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setRemoteVoicePositionEx(_:pan:gain:connection:));
```

<a id="api_irtcengineex_setremotevoicepositionex__detailed_desc"></a>

你可以使用该方法设置远端用户的语音位置和音量。调用该方法设置远端用户的语音位置后，左右声道的声音差异可以帮助你实时感知远端用户的位置，增强空间感。该方法适用于大型多人在线游戏，例如大逃杀类游戏。

:::note
注：

- 为获得最佳语音定位效果，声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
:::

<a id="api_irtcengineex_setremotevoicepositionex__scenario"></a>

### 适用场景 [#适用场景]

该方法适用于多频道场景。

<a id="api_irtcengineex_setremotevoicepositionex__parameters"></a>

### 参数 [#参数-2]

<ParameterList>
<a id="uid-1"></a>
<Parameter name="uid">

远端用户的用户 ID。

</Parameter>
<a id="pan-1"></a>
<Parameter name="pan">

远端用户的语音位置。取值范围为 -1.0 到 1.0：

- -1.0：远端语音来自左侧。
- 0.0（默认）：远端语音来自正前方。
- 1.0：远端语音来自右侧。

</Parameter>
<a id="gain-1"></a>
<Parameter name="gain">

远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0（远端用户的原始音量）。值越小，音量越低。

</Parameter>
<a id="connection"></a>
<Parameter name="connection">

连接信息，详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/ios/class-rtcconnection)。

</Parameter>
</ParameterList>

<a id="api_irtcengineex_setremotevoicepositionex__return_values"></a>

### 返回值 [#返回值-2]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-2]

- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineex)