TRTCRemoteStatistics

TRTCRemoteStatistics

远端成员的音视频统计信息

Constructor

new TRTCRemoteStatistics(userId, audioPacketLoss, videoPacketLoss, width, height, frameRate, videoBitrate, audioSampleRate, audioBitrate, jitterBufferDelay, point2PointDelay, audioTotalBlockTime, audioBlockRate, videoTotalBlockTime, videoBlockRate, finalLoss, remoteNetworkUplinkLoss, remoteNetworkRTT, streamType)

Parameters:
Name Type Description
userId String required

用户 ID,指定是哪个用户的视频流

audioPacketLoss Number required

音频流的总丢包率(%) audioPacketLoss 代表音频流历经主播>云端>观众这样一条完整的传输链路后,最终在观众端统计到的丢包率。 audioPacketLoss 越小越好,丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。 如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况,说明该路音频流在“云端=>观众”这一段链路上没有出现丢包, 但是在主播>云端这一段链路上出现了不可恢复的丢包。

videoPacketLoss Number required

该路视频流的总丢包率(%) videoPacketLoss 代表该路视频流历经主播>云端>观众这样一条完整的传输链路后,最终在观众端统计到的丢包率。 videoPacketLoss 越小越好,丢包率为0即表示该路视频流的所有数据均已经完整地到达了观众端。 如果出现了 downLoss == 0 但 videoPacketLoss != 0 的情况,说明该路视频流在云端>观众这一段链路上没有出现丢包, 但是在主播>云端这一段链路上出现了不可恢复的丢包。

width Number required

视频宽度

height Number required

视频高度

frameRate Number required

接收帧率(fps)

videoBitrate Number required

视频码率(Kbps)

audioSampleRate Number required

音频采样率(Hz)

audioBitrate Number required

音频码率(Kbps)

jitterBufferDelay Number required

播放时延(ms)

point2PointDelay Number required

端到端延迟(ms) point2PointDelay 代表 “主播=>云端=>观众” 的延迟,更准确地说,它代表了“采集=>编码=>网络传输=>接收=>缓冲=>解码=>播放” 全链路的延迟。 point2PointDelay 需要本地和远端的 SDK 均为 8.5 及以上的版本才生效,若远端用户为 8.5 以前的版本,此数值会一直为0,代表无意义。

audioTotalBlockTime Number required

音频播放卡顿累计时长(ms)

audioBlockRate Number required

音频播放卡顿率,音频卡顿累计时长占音频总播放时长的百分比 (%)

videoTotalBlockTime Number required

视频播放卡顿累计时长(ms)

videoBlockRate Number required

视频播放卡顿率,视频卡顿累计时长占音频总播放时长的百分比(%)

finalLoss Number required

该线路的总丢包率(%)。已废弃,不推荐使用;建议使用 audioPacketLoss、videoPacketLoss 替代

remoteNetworkUplinkLoss Number required

该用户从 SDK 到云端的上行丢包率,单位 (%) 该数值越小越好,如果 remoteNetworkUplinkLoss 为 0%,则意味着上行链路的网络质量很好,上传到云端的数据包基本不发生丢失。 如果 remoteNetworkUplinkLoss 为 30%,则意味着 SDK 向云端发送的音视频数据包中,会有 30% 丢失在传输链路中。

remoteNetworkRTT Number required

该用户从 SDK 到云端的往返延时,单位 ms 该数值代表从 SDK 发送一个网络包到云端,再从云端回送一个网络包到 SDK 的总计耗时,也就是一个网络包经历 “SDK=>云端=>SDK” 的总耗时。 该数值越小越好:如果 remoteNetworkRTT < 50ms,意味着较低的音视频通话延迟;如果 remoteNetworkRTT > 200ms,则意味着较高的音视频通话延迟。 需要特别解释的是,remoteNetworkRTT 代表 “SDK=>云端=>SDK” 的总耗时,所以不需要区分 remoteNetworkUpRTT 和 remoteNetworkDownRTT

streamType TRTCVideoStreamType required

流类型(大画面 | 小画面 | 辅路画面)