RTCRemoteOutboundRtpStreamStats

Baseline 广泛可用 *

此功能已经非常成熟,并且在许多设备和浏览器版本中均可正常工作。自 ⁨2021 年 5 月⁩ 起,浏览器均已支持此功能。

* 此特性的某些部分可能存在不同级别的支持。

RTCRemoteOutboundRtpStreamStats 字典是 WebRTC API 的一部分,用于报告来自远程端点的关于其出站 RTP 流的统计信息。这对应于本地 RTCPeerConnection 对象当前正在接收的入站流。

可以通过迭代 RTCPeerConnection.getStats() 返回的 RTCStatsReport 来获取统计信息,直到找到一个 type 属性为 remote-outbound-rtp 的报告。

实例属性

远程出站特定统计信息

localId 可选

一个字符串,用于查找具有相同 同步源 (SSRC) 的本地 RTCInboundRtpStreamStats 对象。

remoteTimestamp 可选

一个 DOMHighResTimeStamp,指定了 RTCRemoteOutboundRtpStreamStats 对象中的统计信息由远程端点发送时(在远程设备上)的时间戳。这与 timestamp 不同;它表示对象统计信息在本地端点接收或生成的时间。

reportsSent 可选 实验性

一个正整数,指示为该 同步源 (SSRC) 发送的 RTCP 发送方报告 (SR) 块的总数。

roundTripTimeMeasurements 可选 实验性

一个正数,表示为该 同步源 (SSRC) 收到的有效往返时间测量值的总数。

totalRoundTripTime 可选 实验性

一个数字,表示自会话开始以来所有往返时间测量值的累积总和,单位为秒。可以通过将 totalRoundTripTime 除以 roundTripTimeMeasurements 来计算平均往返时间。

已发送 RTP 流的统计信息

bytesSent 可选

一个正整数,指示为该 SSRC 发送的总字节数,包括重传。

packetsSent 可选

一个正整数,指示为该 SSRC 发送的总 RTP 数据包数,包括重传。

常见 RTP 流统计信息

codecId 可选

一个字符串,用于唯一标识用于生成与此 RTP 流关联的 RTCCodecStats 报告的对象。

kind

一个字符串,指示与该流关联的 MediaStreamTrack 是音频轨道还是视频轨道。

ssrc

一个正整数,用于标识此流中 RTP 数据包的同步源 (SSRC)。

transportId 可选

一个字符串,用于唯一标识用于生成与此 RTP 流关联的 RTCTransportStats 报告的对象。

常见实例属性

以下属性是所有 WebRTC 统计信息对象共有的。

id

一个字符串,唯一标识正在监控以生成这组统计信息的对象。

时间戳

一个 DOMHighResTimeStamp 对象,表示此统计信息对象样本的采集时间。

type

一个值为 "remote-outbound-rtp" 的字符串,表示该对象包含的统计信息的类型。

用法说明

RTCRemoteOutboundRtpStreamStats 对象的 remoteTimestamp 属性提供了基于从 RTCP 发送方报告 (SR) 块获取的接收数据的 NTP 时间戳的统计信息。请注意,远程时钟可能与本地时钟不同步(无论是当前时间还是时间流逝的速度)。

规范

规范
WebRTC 统计 API 的标识符
# dom-rtcstatstype-remote-outbound-rtp

浏览器兼容性