RTCRtpSender:getStats() 方法

Baseline 已廣泛支援

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

RTCRtpSender 方法 getStats() 會非同步請求一個 RTCStatsReport 物件,該物件提供關於擁有該傳送器的 RTCPeerConnection 上傳出流量的統計資訊,並返回一個 Promise,當結果可用時該 Promise 會被 fulfilled。

語法

js
getStats()

引數

無。

返回值

一個 JavaScript Promise,一旦統計資料可用就會被 fulfilled。Promise 的 fulfilled 處理程式會接收一個 RTCStatsReport 物件作為引數,其中包含收集到的統計資料。

返回的 RTCStatsReport 會累積使用 RTCRtpSender 傳送的所有流的統計資料,以及這些流所依賴的任何統計資料。

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

示例

這個簡單的例子獲取 RTCRtpSender 的統計資訊,並更新元素的 innerText 以顯示傳送器上請求的當前往返時間。

js
sender.getStats().then((stats) => {
  document.getElementById("currentRTT").innerText = stats.roundTripTime;
});

規範

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

瀏覽器相容性

另見