RTCRtpSender:getStats() 方法
RTCRtpSender 方法 getStats() 會非同步請求一個 RTCStatsReport 物件,該物件提供關於擁有該傳送器的 RTCPeerConnection 上傳出流量的統計資訊,並返回一個 Promise,當結果可用時該 Promise 會被 fulfilled。
語法
js
getStats()
引數
無。
返回值
一個 JavaScript Promise,一旦統計資料可用就會被 fulfilled。Promise 的 fulfilled 處理程式會接收一個 RTCStatsReport 物件作為引數,其中包含收集到的統計資料。
返回的 RTCStatsReport 會累積使用 RTCRtpSender 傳送的所有流的統計資料,以及這些流所依賴的任何統計資料。
這些可能包括,例如,具有 型別 的統計資料:outbound-rtp、candidate-pair、local-candidate、remote-candidate。
示例
這個簡單的例子獲取 RTCRtpSender 的統計資訊,並更新元素的 innerText 以顯示傳送器上請求的當前往返時間。
js
sender.getStats().then((stats) => {
document.getElementById("currentRTT").innerText = stats.roundTripTime;
});
規範
| 規範 |
|---|
| WebRTC:瀏覽器中的即時通訊 # widl-RTCRtpSender-getStats-Promise-RTCStatsReport |
瀏覽器相容性
載入中…