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

瀏覽器相容性