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