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

瀏覽器相容性

另見