RTCRtpReceiver: getStats() 方法
RTCRtpReceiver
的 getStats()
方法会异步请求一个 RTCStatsReport
对象,该对象提供有关拥有它的 RTCPeerConnection
上传入流量的统计信息,并返回一个 Promise
。一旦结果可用,其fulfilled处理程序将被调用。
语法
js
getStats()
参数
无。
返回值
一个 JavaScript Promise
,在统计信息可用后fulfilled。Promise 的 fulfilled 处理程序接收一个包含收集到的统计信息的 RTCStatsReport
对象作为参数。
返回的统计信息包括通过 RTCRtpReceiver
传入的所有流的统计信息,以及它们的任何依赖项。
例如,这些可能包括具有 类型 的统计信息: inbound-rtp
、candidate-pair
、local-candidate
、remote-candidate
。
示例
这个简单的例子获取 RTCRtpReceiver
的统计信息,并更新元素的 innerText
以显示丢失的数据包数量。
js
receiver.getStats().then((stats) => {
document.getElementById("lost-packets").innerText = stats.packetsLost;
});
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # widl-RTCRtpReceiver-getStats-Promise-RTCStatsReport |
浏览器兼容性
加载中…