监测发言者音量
更新时间: 2024/09/18 16:26:13
在语音连麦、视频会议等场景中,开发者应用层常常需要了解到发言者的人声相关信息,从而做出 UI 上的音量展示或根据发言者的音量大小进行视图布局的动态调整。
NERTC SDK 提供监听房间内用户发送的音量值的功能。
功能介绍
NERTC SDK 支持根据您设置的时间间隔,定期通过回调返回本端发流用户的瞬时音量值,同时返回最多三位瞬时音量最高的远端用户的相关音量信息,即当前正在发言的用户 ID 和用户音频主流的瞬时音量值。
注意事项
- 若本端用户调用
MuteLocalAudioStream
方法静音本地音频,SDK 会将音量设置为 0 后通过OnLocalAudioVolumeIndication
回调返回静音信息,但此回调默认禁用,只可通过EnableAudioVolumeIndication
方法开启。 - 成功启用人声监测功能后,无论房间内是否有人发言,SDK 都会按指定的时间间隔触发
OnLocalAudioVolumeIndication
和OnRemoteAudioVolumeIndication
回调。 - 返回的
OnRemoteAudioVolumeIndication
回调中,若speakers
数组为空,则表示此时远端没有上行的音频主流数据;若上次返回的数组中出现的 uid 不在本次返回的数组中,则默认该 uid 对应的远端用户没有发言。
实现方法
配置步骤
- 调用
EnableAudioVolumeIndication
方法,启用发言者的人声监测。音量提示的时间间隔值必须设置为 100 毫秒的整数倍,建议设置为 200 毫秒及以上。
- 成功启用人声监测功能后,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 及用户瞬时音量的回调 |
此文档是否对你有帮助?