setRemoteVoicePosition method Null safety

Future<void> setRemoteVoicePosition(
  1. int uid,
  2. double pan,
  3. double gain
)

设置远端用户声音的空间位置和音量,方便本地用户听声辨位。

用户通过调用该接口,设置远端用户声音出现的位置,左右声道的声音差异会让用户产生声音的方位感, 从而判断出远端用户的实时位置。在多人在线游戏场景,如吃鸡游戏中,该方法能有效增加游戏角色的方位感,模拟真实场景。

Note

  • 使用该方法需要在加入频道前调用 RtcEngine.enableSoundPositionIndication 开启远端用户的语音立体声。
  • 为获得最佳听觉体验,我们建议用户佩戴有线耳机。

Parameter uid 远端用户的 ID。

Parameter pan 设置远端用户声音出现的位置,取值范围为 -1.0,1.0

  • 0.0:(默认)声音出现在正前方。
  • -1.0:声音出现在左边。
  • 1.0:声音出现在右边

Parameter gain 设置远端用户声音的音量,取值范围为 0.0,100.0,默认值为 100.0,表示该用户的原始音量。取值越小,则音量越低。

Implementation

@override
Future<void> setRemoteVoicePosition(int uid, double pan, double gain) {
  return _invokeMethod('setRemoteVoicePosition', {
    'uid': uid,
    'pan': pan,
    'gain': gain,
  });
}