RTCOutboundRtpStreamStats

Baseline 广泛可用 *

此功能已广泛建立,并可在多种设备和浏览器版本中使用。自 ⁨2020 年 2 月⁩ 起,浏览器均已支持该功能。

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

WebRTC API 中的 RTCOutboundRtpStreamStats 字典用于报告与 RTCRtpSender 所发送的出站 RTP 流相关的指标和统计信息。

可以通过迭代 RTCPeerConnection.getStats()RTCRtpSender.getStats() 返回的 RTCStatsReport,直到找到 typeoutbound-rtp 的报告来获取统计信息。

实例属性

active 实验性

一个布尔值,指示此 RTP 流是否配置为发送,或已被禁用。

frameHeight

一个整数,表示最后一个编码帧的高度(以像素为单位)。音频流下未定义。

frameWidth

一个整数,表示最后一个编码帧的宽度(以像素为单位)。音频流下未定义。

framesEncoded

到目前为止,此 RTP 流成功编码并准备发送的帧数。音频流下未定义。

framesPerSecond

一个数字,表示上一秒发送的已编码帧数。音频流下未定义。

framesSent

一个正整数,表示此 RTP 流上发送的总编码帧数。音频流下未定义。

headerBytesSent

一个正整数,表示为此 SSRC 发送的总 RTP 头和填充字节数。

keyFramesEncoded 实验性

一个正整数,表示此 RTP 媒体流中成功编码的总关键帧数。音频流下未定义。

mediaSourceId

一个字符串,表示当前附加到该流的发送方的轨道的统计对象 ID。

一个字符串,唯一标识了收发器的流的源和目标配对。这是相应的 RTCRtpTransceiver.mid 的值,除非该值为 null,在这种情况下,统计属性将不存在。

nackCount

一个整数值,指示此 RTCRtpSender 从远程 RTCRtpReceiver 收到的否定确认 (NACK) 数据包的总数。此本地计算值可指示连接的错误恢复能力。

qpSum

一个 64 位值,包含此 RTCRtpSender 编码的每个帧的 QP 值之和。此本地计算值可指示数据的压缩程度。音频流下未定义。

qualityLimitationDurations 实验性

一个映射,记录了媒体流分辨率或帧率因各种原因而降低的情况,以及每种原因导致质量降低的时间。音频流下未定义。

qualityLimitationReason 实验性

一个字符串,指示流质量受限的原因。可能的值包括:nonecpubandwidthother音频流下未定义。

remoteId

一个字符串,标识了 RTCRemoteInboundRtpStreamStats 对象,该对象提供了此 SSRC 的远程对等方的统计信息。此 ID 在多次调用 getStats() 时保持稳定。

retransmittedBytesSent

一个正整数,表示与此流关联的源重新传输的总字节数。

retransmittedPacketsSent

一个正整数,表示与此流关联的源重新传输的总数据包数。

rid

一个字符串,指示对应视频流的 RTP 流 ID。

scalabilityMode 实验性

如果已配置,则表示 RTP 流的可扩展性模式的字符串。

targetBitrate

一个数字,表示 RTCRtpSender 的编解码器当前尝试为该流达到的比特率。

totalEncodeTime

一个数字,表示为该流的 RTCRtpSender 编码的帧的总编码时间(秒)。音频流下未定义。

totalEncodedBytesTarget 实验性

到目前为止,所有已编码帧的目标帧大小的累加和。这很可能与实际帧大小的总和不同。音频流下未定义。

totalPacketSendDelay

一个数字,表示数据包在本地缓冲后发送的总时间(秒)。

已发送 RTP 流统计信息

bytesSent 可选

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

packetsSent 可选

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

常见 RTP 流统计信息

codecId 可选

一个字符串,唯一标识了用于生成此 RTP 流关联的 RTCCodecStats 对象的检查对象。

kind

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

ssrc

一个正整数,标识此流中 RTP 数据包的 SSRC。

transportId 可选

一个字符串,唯一标识被检查以生成与此 RTP 流关联的 RTCTransportStats 对象的对象。

常见实例属性

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

id

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

时间戳

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

type

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

规范

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

浏览器兼容性

另见