通话中质量监测

更新时间: 2024/09/18 16:26:13

在通话场景中,开发者经常需要了解当前通话的通话质量、设备状态等信息,监测通话的整体体验。NERTC SDK 支持将关键的音视频状况、网络状况、设备状态的相关指标实时回调给 App 应用层,应用层可以将收到的数据进行展示或统计,使用户能够及时了解当前通话的整体质量。

例如,在进行多人连麦时,您可以展示用户的实时网络质量,类似下图所示。

文本

功能介绍

NERTC SDK 提供注册质量监测观测器 IRtcMediaStatsObserver 的接口与相关回调方法,支持在通话中实时同步并返回质量数据,包括上下行网络质量、本地通话统计信息、本地和远端的音视频流统计信息等。

示例项目

网易云信提供 MediaStats 示例项目源码,您可以参考该源码实现通话中质量监测。

实现方法

调用 setStatsObserver 方法注册质量观测器,主动设置相应回调,回调名称与返回的质量数据信息的对应关系如下表所示。

回调 统计信息
onNetworkQuality 上下行网络质量同步
onRtcStats 统计信息同步
onLocalAudioStatsonRemoteAudioStats 音频质量同步
onLocalVideoStatsonRemoteVideoStats 视频质量同步

若您需要关闭质量监测功能,再次调用此方法并传入 null 即可。

示例代码如下:

c++//StatsObserver.h
class StatsObserver : IRtcMediaStatsObserver
{
public:
    //当前通话统计回调
    virtual void onRtcStats(const nertc::NERtcStats &stats) override;
    //本地音频流统计信息回调
    virtual void onLocalAudioStats(const nertc::NERtcAudioSendStats &stats) override;
    //通话中远端音频流的统计信息回调
    virtual void onRemoteAudioStats(const nertc::NERtcAudioRecvStats *stats, unsigned int user_count) override;
    //本地视频流统计信息回调
    virtual void onLocalVideoStats(const nertc::NERtcVideoSendStats &stats) override;
    //通话中远端视频流的统计信息回调
    virtual void onRemoteVideoStats(const nertc::NERtcVideoRecvStats *stats, unsigned int user_count) override;
    //通话中每个用户的网络上下行质量报告回调
    virtual void onNetworkQuality(const nertc::NERtcNetworkQualityInfo *infos, unsigned int user_count) override;

};

StatsObserver *observer = new StatsObserver();
rtc_engine_->setStatsObserver(observer);

相关回调的详细说明

上下行网络质量同步

onNetworkQuality 回调以数组的形式向您同步当前通话中每个成员的上下行网络质量。

  • 上行网络质量打分基于实际发送码率、上行网络丢包率、平均往返时延和上行网络抖动计算。
  • 下行网络质量打分基于下行网络丢包率、平均往返时延和下行网络抖动计算。
  • 每隔 2 秒您会收到房间内所有用户的网络质量同步。
  • 实际发送码率与目标发送码率的比值越高,该网络下的通话质量越好,该网络质量打分越高。

NERtcNetworkQualityInfo 数组中各参数的说明如下表所示。

参数 参数说明
uid 用户 ID,指定是哪个用户的网络质量统计。
tx_quality 该用户的上行网络质量。
rx_quality 该用户的下行网络质量。

其中网络质量 NERtcNetworkQualityType 的各枚举值如下表所示。

枚举值 说明
kNERtcNetworkQualityUnknown 当前网络质量未知。
kNERtcNetworkQualityExcellent 当前网络质量极好。
kNERtcNetworkQualityGood 当前网络状态不错。
kNERtcNetworkQualityPoor 当前网络状态一般。
kNERtcNetworkQualityBad 当前网络状态比较差,可能出现卡顿和网络延迟。
kNERtcNetworkQualityVeryBad 当前网络状态非常差,无法保证正常的通话质量。
kNERtcNetworkQualityDown 完全无法沟通。

统计信息同步

onRtcStats 回调向您同步本地通话统计信息。其中包含通话时长、当前通话房间中的人数、当前系统的 CPU 使用率、当前 App 的 CPU 使用率等重要数据。

参数 参数说明
cpu_app_usage、cpu_idle_usage、cpu_total_usage App 的 CPU 使用率、系统的 CPU 空闲率和系统的 CPU 使用率。
memory_app_usage、memory_app_kbytes、memory_total_usage App 的内存使用率、内存使用量、系统的内存使用率。
total_duration 通话总时长,单位为秒。
tx_bytes、rx_bytes 累计发送、接收字节数。
tx_audio_bytes、rx_audio_bytes 音频发送、接收字节数。
tx_video_bytes、rx_video_bytes 视频发送、接收字节数。
tx_audio_kbitrate、rx_audio_kbitrate 音频接收、发送码率,单位为 Kbps。
tx_video_kbitrate、rx_video_kbitrate 视频接收、发送码率,单位为 Kbps。
up_rtt、down_rtt 上行、下行平均往返时延,单位为毫秒。
tx_audio_packet_loss_rate、rx_audio_packet_loss_rate 本地上行、下行音频实际丢包率。
tx_audio_packet_loss_sum、rx_audio_packet_loss_sum 本地上行、下行音频实际丢包数。
tx_audio_jitter、rx_audio_jitter 本地上行、下行音频抖动计算,单位为毫秒。
tx_video_jitter、rx_video_jitter 本地上行、下行视频抖动计算,单位为毫秒。
tx_video_packet_loss_rate、rx_video_packet_loss_rate 本地上行、下行视频实际丢包率。
tx_video_packet_loss_sum、rx_video_packet_loss_sum 本地上行、下行视频实际丢包数。

音频质量同步

本地音频流统计信息同步

onLocalAudioStats 回调向您同步本地设备发送音频流的统计信息,包括当前通话声道数(单声道或双声道)、发送音频的采样率和发送音频的码率。SDK 会每隔 2 秒自动触发本回调。

参数 描述
num_channels 当前采集的声道数。
sent_sample_rate 统计周期内本地上行音频采样率,单位为 Hz。
sent_bitrate 统计周期内发送码率的平均值,单位为 Kbps。
audio_loss_rate 特定时间内的音频丢包率。
rtt 平均往返时延(RTT)。
volume 音量,范围为 0 ~ 100。
cap_volume 采集音量,范围为 0 ~ 100。

远端音频流统计信息同步

onRemoteAudioStats 回调向您同步当前通话中每个远端用户音频流的统计信息,包括每个远端用户发送的音频流质量、声道数等信息。SDK 会每隔 2 秒自动触发本回调。

stats 的参数说明如下表所示。

参数 参数说明
uid 用户 ID,指定是哪个用户的音频流。
audio_layers_count 音频流条数。
audio_layers_list
stream_type 音频流通道类型,包括如下两种类型:
  • kNERtcAudioStreamTypeMain :主流
  • kNERtcAudioStreamTypeSub :辅流
received_bitrate 统计周期内接收到的码率平均值,单位为 Kbps。
total_frozen_time 远端用户在加入房间后发生音频卡顿的累计时长,单位为毫秒。一个统计周期内,音频丢帧率达到 4% 即记为一次音频卡顿。
frozen_rate 远端用户下行音频平均卡顿率。其值为远端用户在加入房间后发生音频卡顿的累计时长占音频总有效时长的百分比。
audio_loss_rate 统计周期内的远端音频流的丢包率。
volume 音量,取值范围为 0 ~ 100。

视频质量同步

本地视频流统计信息同步

onLocalVideoStats 回调向您同步本地设备发送视频流的统计信息,包括视频编码宽/高等信息。SDK 会每隔 2 秒自动触发本回调。

如果您此前调用 enableDualStreamMode 方法开启了双流模式,则本回调描述本地设备发送的视频大流的统计信息。

video_layers_list的参数说明如下表所示。

参数 参数说明
layer_type 视频流通道类型。
  • 1:主流。
  • 2:辅流。
  • width 视频编码宽度,单位为 px。
    height 视频编码高度,单位为 px。
    capture_width 视频采集宽度,单位为 px。
    capture_height 视频采集高度,单位为 px。
    capture_frame_rate 视频采集帧率,单位为 fps。
    render_frame_rate 视频渲染帧率,单位为 fps。
    encoder_frame_rate 编码帧率,单位为 fps。
    sent_frame_rate 实际发送帧率,单位为 fps,不包含丢包后重传视频等的发送帧率。
    sent_bitrate 实际发送码率,单位为 Kbps,不包含丢包后重传视频等的发送码率。
    target_bitrate 当前编码器的目标编码码率,单位为 Kbps,该码率为 SDK 根据当前网络状况预估的一个值。
    encoder_bitrate 编码器实际编码码率,单位为 Kbps。
    codec_name 视频编码器的名称。
    drop_bandwidth_strategy_enabled 是否开启超分降带宽策略。

    远端视频流统计信息同步

    onRemoteVideoStats 回调向您同步当前通话中每个远端用户/主播的视频流的统计信息,包括每个远端用户的视频宽/高等参数信息。SDK 会每隔 2 秒自动触发本回调。

    stats 的参数说明如下表所示。

    参数 参数说明
    uid 用户 ID,指定是哪个用户的视频流。
    audio_layers_count 视频流条数。
    video_layers_list
    layer_type 视频流通道类型。
  • 1:主流。
  • 2:辅流。
  • width 远端视频编码宽度,单位为 px。
    height 远端视频编码高度,单位为 px。
    received_bitrate 接收到的码率,单位为 Kbps。
    received_frame_rate 接收到的帧率,单位为 fps。
    decoder_frame_rate 解码帧率,单位为 fps。
    render_frame_rate 渲染帧率,单位为 fps。
    packet_loss_rate 远端视频下行丢包率。
    total_frozen_time 远端用户加入房间后,其下行视频卡顿累计时长,单位为毫秒。
    frozen_rate 远端用户加入房间后,其下行视频平均卡顿率,其值为视频卡顿的累计时长占视频总有效时长的百分比。
    codec_name 视频编码器的名称。
    此文档是否对你有帮助?
    有帮助
    去反馈
    • 功能介绍
    • 示例项目
    • 实现方法
    • 相关回调的详细说明
    • 上下行网络质量同步
    • 统计信息同步
    • 音频质量同步
    • 视频质量同步