RTCRtpReceiver: getStats() 方法

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2019 年 3 月以來,它已在所有瀏覽器中可用。

RTCRtpReceivergetStats() 方法會非同步請求一個 RTCStatsReport 物件,該物件提供有關擁有它的 RTCPeerConnection 上傳入流量的統計資訊,並返回一個 Promise。一旦結果可用,其fulfilled處理程式將被呼叫。

語法

js
getStats()

引數

無。

返回值

一個 JavaScript Promise,在統計資訊可用後fulfilled。Promise 的 fulfilled 處理程式接收一個包含收集到的統計資訊的 RTCStatsReport 物件作為引數。

返回的統計資訊包括透過 RTCRtpReceiver 傳入的所有流的統計資訊,以及它們的任何依賴項。

例如,這些可能包括具有 型別 的統計資訊: inbound-rtpcandidate-pairlocal-candidateremote-candidate

示例

這個簡單的例子獲取 RTCRtpReceiver 的統計資訊,並更新元素的 innerText 以顯示丟失的資料包數量。

js
receiver.getStats().then((stats) => {
  document.getElementById("lost-packets").innerText = stats.packetsLost;
});

規範

規範
WebRTC:瀏覽器中的即時通訊
# widl-RTCRtpReceiver-getStats-Promise-RTCStatsReport

瀏覽器相容性

另見