在语音连麦、视频会议等场景中，开发者应用层常常需要了解到发言者的人声相关信息，从而做出 UI 上的音量展示或根据发言者的音量大小进行视图布局的动态调整。

NERTC SDK 提供监听房间内用户发送的音量值的功能。

功能介绍

NERTC SDK 支持根据您设置的时间间隔，定期通过回调返回本端发流用户的瞬时音量值，同时返回最多三位瞬时音量最高的远端用户的相关音量信息，即当前正在发言的用户 ID 和用户音频主流的瞬时音量值。

注意事项

• 若本端用户调用 MuteLocalAudioStream 方法静音本地音频，SDK 会将音量设置为 0 后通过 OnLocalAudioVolumeIndication 回调返回静音信息，但此回调默认禁用，只可通过 EnableAudioVolumeIndication 方法开启。
• 成功启用人声监测功能后，无论房间内是否有人发言，SDK 都会按指定的时间间隔触发 OnLocalAudioVolumeIndication 和 OnRemoteAudioVolumeIndication 回调。
• 返回的 OnRemoteAudioVolumeIndication 回调中，若 speakers 数组为空，则表示此时远端没有上行的音频主流数据；若上次返回的数组中出现的 uid 不在本次返回的数组中，则默认该 uid 对应的远端用户没有发言。

实现方法

配置步骤

1. 调用 EnableAudioVolumeIndication 方法，启用发言者的人声监测。

   音量提示的时间间隔值必须设置为 100 毫秒的整数倍，建议设置为 200 毫秒及以上。

2. 成功启用人声监测功能后，SDK 返回以下回调通知：
   • OnLocalAudioVolumeIndication：房间内本地用户瞬时音量的回调。
   • OnRemoteAudioVolumeIndication：房间内正在发言的用户 ID 及用户音频主流的瞬时音量的回调。

示例代码

C#//音量监测
private void enableAudioVolumeIndication()
{
    //开启音量监测
    rtcEngine.OnLocalAudioVolumeIndication = EngineOnLocalAudioVolumeIndication;
    rtcEngine.OnRemoteAudioVolumeIndication = EngineOnRemoteAudioVolumeIndication;
    rtcEngine.EnableAudioVolumeIndication(true, 1000);

    //关闭音量监测
    rtcEngine.EnableAudioVolumeIndication(false, 0);
}

private void EngineOnRemoteAudioVolumeIndication(RtcAudioVolumeInfo[] speakers, int totalVolume)
{
    //
}

private void EngineOnLocalAudioVolumeIndication(int volume)
{
    //
}

API 参考

方法	功能描述
EnableAudioVolumeIndication	启用发言者的人声监测
OnLocalAudioVolumeIndication	房间内本地用户瞬时音量的回调
OnRemoteAudioVolumeIndication	房间内正在发言的用户 ID 及用户瞬时音量的回调