RTCOutboundRtpStreamStats
Baseline 广泛可用 *
WebRTC API 中的 RTCOutboundRtpStreamStats 字典用于报告与 RTCRtpSender 所发送的出站 RTP 流相关的指标和统计信息。
可以通过迭代 RTCPeerConnection.getStats() 或 RTCRtpSender.getStats() 返回的 RTCStatsReport,直到找到 type 为 outbound-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实验性-
一个字符串,指示流质量受限的原因。可能的值包括:
none、cpu、bandwidth或other。音频流下未定义。 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 |
浏览器兼容性
加载中…