通话数据统计
音视频通话过程中,底层音视频库会按照 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
说明:回调参数 回调类型 说明 stats RCRTCRemoteAudioStats 合流音频接收质量状态信息 setOnLiveMixMemberAudioStatsListener
说明:在直播场景下,观众可以通过该回调获取正在说话的主播的音量。
回调参数 回调类型 说明 userId string 远端用户 ID volume number 远端用户 ID 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
示例代码
/// 设置状态监听回调
rtcEngine.setOnNetworkStatsListener((stats) => {
// 网络状态信息
});
rtcEngine.setOnLocalAudioStatsListener((stats: RCRTCLocalAudioStats) => {
// 音频发送状态信息
});
rtcEngine.setOnLocalVideoStatsListener((stats: RCRTCLocalVideoStats) => {
// 视频发送状态信息
});
rtcEngine.setOnRemoteAudioStatsListener((roomId: string, userId: string, stats: RCRTCRemoteAudioStats) => {
// 音频接收状态信息
});
rtcEngine.setOnRemoteVideoStatsListener((roomId: string, userId: string, stats: RCRTCRemoteVideoStats) => {
// 视频接收状态信息
});
rtcEngine.setOnLiveMixAudioStatsListener((stats: RCRTCRemoteAudioStats) => {
// 合流音频接收状态信息
});
rtcEngine.setOnLiveMixVideoStatsListener((stats: RCRTCRemoteVideoStats) => {
// 合流视频接收状态信息
});
rtcEngine.setOnLocalCustomVideoStatsListener((roomId: string, userId: string, tag: string, stats: RCRTCRemoteVideoStats) => {
// 自定义视频发送状态信息
});
rtcEngine.setOnRemoteCustomVideoStatsListener((roomId: string, userId: string, tag: string, stats: RCRTCRemoteVideoStats) => {
// 自定义视频接收状态信息
});
/// 调用以上接口参数为空,即为取消状态监听回调。如下示例
// 取消网络状态监听
rtcEngine.setOnNetworkStatsListener();