RTCRtpSender: getStats() 方法
该 RTCRtpSender
方法 getStats()
异步请求一个 RTCStatsReport
对象,该对象提供有关拥有发送者的 RTCPeerConnection
上传出流量的统计信息,并返回一个 Promise
,当结果可用时,该 Promise
将被执行。
语法
js
getStats()
参数
无。
返回值
一个 JavaScript Promise
,在统计信息可用后执行。promise 的执行处理程序接收一个 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 |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。