听声辨位

  • Android

更新时间不可用

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:方法调用失败。详见错误码了解详情和解决建议。

所属接口类