听声辨位
enableSoundPositionIndication:
启用或关闭远端用户的立体声声像功能。
Objective-C
- (int)enableSoundPositionIndication:(BOOL)enabled NS_SWIFT_NAME(enableSoundPositionIndication(_:));
请确保在加入频道前调用该方法，从而使你可以通过调用 setRemoteVoicePosition:pan:gain: 跟踪远端用户的位置。
参数
- enabled
- 是否启用远端用户的立体声声像功能：
- YES：启用立体声声像。
- NO：关闭立体声声像。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRemoteVoicePosition:pan:gain:
设置远端用户语音的二维位置和音量。
Objective-C
- (int)setRemoteVoicePosition:(NSUInteger)uid pan:(double)pan gain:(double)gain NS_SWIFT_NAME(setRemoteVoicePosition(_:pan:gain:));
该方法设置远端用户的二维位置和音量，使你可以更容易地听到并识别远端用户的位置。通过左右声道的声音差异，你可以实时追踪远端用户的位置，从而营造空间感。该方法适用于大型多人在线游戏，例如大逃杀类游戏。
信息
- 要使该方法生效，请在加入频道前调用 enableSoundPositionIndication: 方法为远端用户开启立体声声道。
- 为获得最佳语音定位效果，声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
参数
- uid
- 远端用户的用户 ID。
- pan
- 远端用户的语音位置。取值范围为 -1.0 到 1.0：
- 0.0：（默认）远端语音来自正前方。
- -1.0：远端语音来自左侧。
- 1.0：远端语音来自右侧。
- gain
- 远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0（远端用户的原始音量）。数值越小，音量越低。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRemoteVoicePositionEx:pan:gain:connection:
设置远端用户语音的二维位置和音量。
Objective-C
- (int)setRemoteVoicePositionEx:(NSUInteger)uid
pan:(double)pan
gain:(double)gain
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setRemoteVoicePositionEx(_:pan:gain:connection:));
你可以使用该方法设置远端用户的语音位置和音量。调用该方法设置远端用户的语音位置后，左右声道的声音差异可以帮助你实时感知远端用户的位置，增强空间感。该方法适用于大型多人在线游戏，例如大逃杀类游戏。
信息
- 为获得最佳语音定位效果，声网建议你使用有线耳机。
- 请在加入频道后调用该方法。
适用场景
该方法适用于多频道场景。
参数
- uid
- 远端用户的用户 ID。
- pan
- 远端用户的语音位置。取值范围为 -1.0 到 1.0：
- -1.0：远端语音来自左侧。
- 0.0（默认）：远端语音来自正前方。
- 1.0：远端语音来自右侧。
- gain
- 远端用户的音量。取值范围为 0.0 到 100.0。默认值为 100.0（远端用户的原始音量）。值越小，音量越低。
- connection
- 连接信息，详见 AgoraRtcConnection。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。