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

浏览器兼容性

另见