RTCStatsReport

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

RTCStatsReport 接口提供了通过调用 RTCPeerConnection.getStats()、RTCRtpReceiver.getStats() 和 RTCRtpSender.getStats() 这三个方法之一所获得的统计报告。

该统计报告包含统计类别字符串名称到包含相应统计数据的对象的映射。

在 RTCPeerConnection 上调用 getStats() 可以让你指定是否希望获取连接上的出站、入站或是所有流的统计信息。getStats() 的 RTCRtpReceiver 和 RTCRtpSender 版本仅返回你调用它们的传入或传出流的统计信息。

统计对象

对于每种统计信息类别，都有一个字典，字典的属性提供相关信息。

所有统计类别共有的属性

所有 WebRTC 统计对象都基于 RTCStats 字典，该字典提供了最基本的信息：时间戳、统计类型字符串和唯一标识数据源的 ID。

统计类别

type 值给出了对象所代表的统计类别的名称。以及如何查找你需要的特定数据的类型。

规范

Specification
WebRTC: Real-Time Communication in Browsers
# rtcstatsreport-object

浏览器兼容性

BCD tables only load in the browser

参见