onAudioVolumeIndication property

void Function(RtcConnection connection, List<AudioVolumeInfo> speakers, int speakerNumber, int totalVolume)? onAudioVolumeIndication
final

用户音量提示回调。

该回调默认禁用，你可以通过 enableAudioVolumeIndication 开启。 开启后，只要频道内有发流用户，SDK 会在加入频道后按 enableAudioVolumeIndication 中设置的时间间隔触发 onAudioVolumeIndication 回调。每次会触发两个 onAudioVolumeIndication 回调，一个报告本地发流用户的音量相关信息，另一个报告瞬时音量最高的远端用户（最多 3 位）的音量相关信息。 启用该功能后，如果有用户将自己静音（调用了 muteLocalAudioStream ），SDK 会继续报告本地用户的音量提示回调。 瞬时音量最高的远端用户静音后 20 秒，远端的音量提示回调中将不再包含该用户；如果远端所有用户都将自己静音，20 秒后 SDK 停止报告远端用户的音量提示回调。

  • connection Connection 信息。详见 RtcConnection 。
  • speakers 用户音量信息，详见 AudioVolumeInfo 数组。如果 speakers 为空，则表示远端用户不发流或没有远端用户。
  • speakerNumber 用户数量。 在本地用户的回调中，只要本地用户在发流， speakerNumber 始终为 1。 在远端用户的回调中， speakerNumber 取值范围为 0,3。如果远端发流用户数量大于 3，则此回调中 speakerNumber 值为 3。
  • totalVolume 混音后的总音量，取值范围为 0,255。 在本地用户的回调中， totalVolume 为本地发流用户的音量。 在远端用户的回调中， totalVolume 为瞬时音量最高的远端用户（最多 3 位）混音后的总音量。

Implementation

final void Function(RtcConnection connection, List<AudioVolumeInfo> speakers,
    int speakerNumber, int totalVolume)? onAudioVolumeIndication;