通话数据统计

音视频通话过程中，底层音视频库会按照 RCRTCEngineSetup 中的 statsReportInterval 指定的时间间隔（默认1秒）上报通话的详细数据，上层依据此数据可进行提示，状态判断等处理。

可通过 RCRTCEngine 中的 setOnNetworkStatsListener 等方法注册监听。

详细说明

• 回调参数说明：

  setOnNetworkStatsListener 说明：

  回调参数	回调类型	说明
  stats	RCRTCNetworkStats	网络状态信息

  setOnLocalAudioStatsListener 说明：

  回调参数	回调类型	说明
  stats	RCRTCLocalAudioStats	音频发送状态信息

  setOnLocalVideoStatsListener 说明：

  回调参数	回调类型	说明
  stats	RCRTCLocalVideoStats	视频发送状态信息

  setOnLocalCustomVideoStatsListener 说明：

  回调参数	回调类型	说明
  tag	string	自定义视频资源 TAG
  stats	RCRTCLocalVideoStats	自定义视频资源发送状态信息

  setOnRemoteAudioStatsListener 说明：

  在直播场景下，主播角色的用户可通过该回调获取房间内正在说法的其他主播及其音量。在会议场景下，与会用户可通过该回调获取房间内正在说法的其他用户及其音量。

  回调参数	回调类型	说明
  roomId	string	远端房间 ID
  userId	string	远端用户 ID
  stats	RCRTCRemoteAudioStats	音频接收质量状态信息

  setOnRemoteVideoStatsListener 说明：

  回调参数	回调类型	说明
  roomId	string	远端房间 ID
  userId	string	远端用户 ID
  stats	RCRTCRemoteVideoStats	视频接收质量状态信息

  setOnLiveMixAudioStatsListener 说明：

  回调参数	回调类型	说明
  callback	RCRTCRemoteAudioStats	合流音频接收质量状态信息

  setOnLiveMixMemberAudioStatsListener 说明：

  在直播场景下，观众可以通过该回调获取正在说话的主播的音量。

  回调参数	回调类型	说明
  callback	OnLiveMixMemberAudioStatsResult	上报远端分流音频统计信息。其中 userId（string） 为远端用户 ID，volume（number）为音量。

  setOnLiveMixVideoStatsListener 说明：

  回调参数	回调类型	说明
  stats	RCRTCRemoteVideoStats	合流视频接收质量状态信息

  setOnRemoteCustomVideoStatsListener 说明：

  回调参数	回调类型	说明
  roomId	string	远端房间 ID
  userId	string	远端用户 ID
  tag	string	远端自定义视频资源 TAG
  stats	RCRTCRemoteVideoStats	自定义视频资源接收质量状态信息

• RCRTCNetworkStats

  属性	类型	说明
  type	RCRTCNetworkType	网络类型，未知/WIFI/移动网络
  ip	string	IP 地址
  sendBitrate	number	发送码率，单位：kbps
  receiveBitrate	number	接收码率，单位：kbps
  rtt	number	往返延时，单位：ms

• RCRTCLocalAudioStats

  属性	类型	说明
  codec	RCRTCAudioCodecType	编码类型，PCMU/OPUS
  bitrate	number	码率，单位：kbps
  volume	number	音量
  packageLostRate	number	丢包率：取值范围是 0-100
  rtt	number	往返延时，单位：ms

• RCRTCLocalVideoStats

  属性	类型	说明
  tiny	bool	小流标记，true 小流，false 大流
  codec	RCRTCVideoCodecType	编码类型，H264
  bitrate	number	码率，单位：kbps
  fps	number	视频帧率
  width	number	视频宽度
  height	number	视频高度
  packageLostRate	number	丢包率：取值范围是 0-100
  rtt	number	往返延时，单位：ms

• RCRTCRemoteAudioStats

  属性	类型	说明
  codec	RCRTCVideoCodecType	编码类型，H264
  bitrate	number	码率，单位：kbps
  volume	number	音量
  packageLostRate	number	丢包率：取值范围是 0-100
  rtt	number	往返延时，单位：ms

• RCRTCRemoteVideoStats

  属性	类型	说明
  codec	RCRTCVideoCodecType	编码类型，H264
  bitrate	number	码率，单位：kbps
  fps	number	视频帧率
  width	number	视频宽度
  height	number	视频高度
  packageLostRate	number	丢包率：取值范围是 0-100
  rtt	number	往返延时，单位：ms

示例代码

/// 设置状态监听回调

engine.setOnNetworkStatsListener((stats) => {
  // 网络状态信息
});
engine.setOnLocalAudioStatsListener((stats) => {
  // 音频发送状态信息
});
engine.setOnLocalVideoStatsListener((stats) => {
  // 视频发送状态信息
});
engine.setOnRemoteAudioStatsListener(({roomId, userId, stats}) => {
  // 音频接收状态信息
});
engine.setOnRemoteVideoStatsListener(({roomId, userId, stats}) => {
  // 视频接收状态信息
});
engine.setOnLiveMixAudioStatsListener((stats) => {
  // 合流音频接收状态信息
});
engine.setOnLiveMixVideoStatsListener((stats) => {
  // 合流视频接收状态信息
});
engine.setOnLocalCustomVideoStatsListener(({tag, stats}) => {
  // 自定义视频发送状态信息
});
engine.setOnRemoteCustomVideoStatsListener(({roomId, userId, tag, stats}) => {
  // 自定义视频接收状态信息
});

/// 调用以上接口参数为空，即为取消状态监听回调。如下示例
// 取消网络状态监听
engine.setOnNetworkStatsListener();