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