setRemoteAudioAttenuation abstract method

Future<void> setRemoteAudioAttenuation({
  1. required int uid,
  2. required double attenuation,
  3. required bool forceSet,
})

设置指定用户的声音衰减效果。

  • uid 用户 ID。需与用户加入频道时填写的用户 ID 一致。
  • attenuation 针对该用户的声音衰减系数,取值范围为0,1。其中:
  • forceSet 是否强制设定该用户的声音衰减效果: true :强制使用 attenuation 设置该用户的声音衰减效果,此时 SpatialAudioZone 中的 audioAttenuation 中设置的隔声区域衰减系数对该用户不生效。 false :不强制使用 attenuation 设置用户的声音衰减效果,分为以下两种情况。 如果音源和听声者分属于隔声区域内部和外部,则声音衰减效果由 SpatialAudioZone 中的 audioAttenuation 决定。 如果音源和听声者在同一个隔声区域内或同在隔声区域外,则声音衰减效果由该方法中的 attenuation 决定。

Returns 方法成功调用时,无返回值;方法调用失败时,会抛出 AgoraRtcException 异常,你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

Future<void> setRemoteAudioAttenuation(
    {required int uid, required double attenuation, required bool forceSet});