听声辨位
enableSoundPositionIndication
启用或关闭远端用户的立体声声像功能。
Java
public abstract int enableSoundPositionIndication(boolean enabled);
请在加入频道前调用该方法。启用后，本地用户可以通过调用 setRemoteVoicePosition 跟踪远端用户的位置。
参数
- enabled
- 是否启用远端用户的立体声声像功能：
- true：启用立体声声像。
- false：关闭立体声声像。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRemoteVoicePosition
设置远端用户语音的二维位置和音量。
Java
public abstract int setRemoteVoicePosition(int uid, double pan, double 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
设置远端用户语音的二维位置和音量。
Java
public abstract int setRemoteVoicePositionEx(int uid, double pan, double gain, RtcConnection connection);
该方法用于设置远端用户的语音位置和音量。调用该方法后，左右声道的声音差异可以让你实时感知远端用户的位置，从而营造空间感。该方法适用于大型多人在线游戏，例如大逃杀类游戏。
信息
- 为获得最佳语音定位效果，声网建议使用有线耳机。
- 请在加入频道后调用该方法。
适用场景
该方法适用于多频道场景。
参数
- uid
- 远端用户 ID。
- pan
- 远端用户的语音位置。取值范围为 -1.0 到 1.0：
- -1.0：远端语音来自左侧；
- 0.0：（默认）远端语音来自正前方；
- 1.0：远端语音来自右侧。
- gain
- 远端用户的音量。取值范围为 0.0 到 100.0，默认值为 100.0（默认）。数值越小，音量越低。
- connection
- 连接信息。详见 RtcConnection。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。