RTCStatsReport

RTCStatsReport 接口提供了通过调用 RTCPeerConnection.getStats() (en-US), RTCRtpReceiver.getStats() (en-US),和 RTCRtpSender.getStats() (en-US) 这三个方法之一所获得的统计报告。该统计报告包含统计类别字符串名称到包含相应统计数据的对象的映射。

RTCPeerConnection 上调用 getStats() 可以指定是希望获取连接上的出站,入站还是所有流的统计信息。 getStats()RTCRtpReceiver (en-US)RTCRtpSender (en-US) 版本仅返回可用于调用它们的传入或传出流的统计信息。

统计对象

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

所有统计类别共有的属性

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

id

A string which uniquely identifies the object which was inspected to produce this object based on RTCStats.

timestamp

A DOMHighResTimeStamp object indicating the time at which the sample was taken for this statistics object.

type

A string indicating the type of statistics the object contains.

统计类别

type (en-US) 给出了对象所代表的统计类别的名称,以及如何查找所需的特定数据类型。统计类别名称是枚举类 RTCStatsType (en-US) 的成员,如下所示:

{{page("/en-US/docs/Web/API/RTCStatsType", "Values")}}

使用 RTCStatsReport

... 即将到来 ...

规范

Specification
WebRTC 1.0: Real-Time Communication Between Browsers
# rtcstatsreport-object

浏览器兼容性

BCD tables only load in the browser

参见