RTCOutboundRtpStreamStats
RTCOutboundRtpStreamStats
是 WebRTC API 的一个字典,用于报告由 RTCRtpSender
发送的出站 RTP 流相关的指标和统计信息。
可以通过迭代 RTCStatsReport
来获取统计信息,该统计信息由 RTCPeerConnection.getStats()
或 RTCRtpSender.getStats()
返回,直到找到类型为 outbound-rtp
的报告。
实例属性
averageRtcpInterval
-
一个浮点值,表示两个连续的复合 RTCP 数据包之间的平均 RTCP 间隔。
firCount
-
一个整数值,表示此
RTCRtpSender
发送到远程RTCRtpReceiver
的完整帧请求 (FIR) 数据包的总数。这反映了流滞后的频率,需要跳过帧以追赶。仅适用于视频流。 framesEncoded
-
到目前为止,已成功编码以在此 RTP 流上发送的帧数。仅适用于视频流。
nackCount
-
一个整数值,表示此
RTCRtpSender
从远程RTCRtpReceiver
收到的负确认 (NACK) 数据包的总数。 perDscpPacketsSent
-
一个键值对记录,字符串作为键映射到 32 位整数值,每个值都表示此
RTCRtpSender
为此来源传输到每个区分服务代码点 (DSCP) 的数据包总数。 pliCount
-
一个整数,指定远程接收方使用图像丢失指示 (PLI) 数据包通知此
RTCRtpSender
一帧或多帧的编码视频数据已丢失的次数。仅适用于视频流。 qpSum
-
一个 64 位值,包含此
RTCRtpSender
编码的每个帧的 QP 值之和。仅适用于视频流。 qualityLimitationDurations
实验性-
一个记录,将
RTCRemoteInboundRtpStreamStats
枚举中的每个质量限制原因映射到一个浮点值,该值表示流因该原因而限制其质量所花费的秒数。 qualityLimitationReason
实验性-
一个字符串,值为
none
、cpu
、bandwidth
或other
之一,解释了为什么此 RTP 流的解析度和/或帧速率受到限制。仅适用于视频流。 remoteId
-
一个字符串,标识提供此相同 SSRC 的远程对等体统计信息的
RTCRemoteInboundRtpStreamStats
对象。此 ID 在多次调用getStats()
时保持稳定。 retransmittedBytesSent
-
在对统计信息进行采样时,到目前为止为此来源重新传输的字节总数。这些重新传输的字节包含
retransmittedPacketsSent
返回的值中包含的数据包。 retransmittedPacketsSent
-
在对统计信息进行采样时,到目前为止为此来源需要重新传输的数据包总数。这些重新传输的数据包包含在
packetsSent
返回的值中。 senderId
-
包含此流的
RTCRtpSender
统计信息的RTCAudioSenderStats
或RTCVideoSenderStats
对象的id
。 sliCount
-
一个整数,表示此发送方从远程对等体接收到的切片丢失指示 (SLI) 帧的次数,表示一个或多个连续的视频宏块已丢失或损坏。仅适用于视频流。
targetBitrate
-
一个值,表示
RTCRtpSender
的编解码器配置为在其输出媒体中尝试达成的比特率。 totalEncodedBytesTarget
实验性-
到目前为止编码的所有帧的目标帧大小(当要求编解码器压缩帧时,帧的目标最大字节数)的累积总和。这可能与实际帧大小的总和不同。
totalEncodeTime
-
一个浮点值,表示到目前为止,此
RTCRtpSender
编码帧所花费的总秒数。 trackId
-
包含当前轨道附加到负责此流的
RTCRtpSender
的RTCSenderAudioTrackAttachmentStats
或RTCSenderVideoTrackAttachmentStats
对象的id
。
通用实例属性
以下属性是所有 WebRTC 统计信息对象的通用属性。
id
-
一个唯一标识正在监控以生成此组统计信息的对象的字符串。
timestamp
-
一个
DOMHighResTimeStamp
对象,表示对该统计信息对象进行采样时的时刻。 type
-
一个值为
"outbound-rtp"
的字符串,表示该对象包含的统计信息类型。
示例
规范
规范 |
---|
WebRTC 统计 API 的标识符 # dom-rtcstatstype-outbound-rtp |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。