RTCRtpSender: getStats() 方法

RTCRtpSender 方法 getStats() 异步请求一个 RTCStatsReport 对象,该对象提供有关拥有发送者的 RTCPeerConnection 上传出流量的统计信息,并返回一个 Promise,当结果可用时,该 Promise 将被执行。

语法

js
getStats()

参数

无。

返回值

一个 JavaScript Promise,在统计信息可用后执行。promise 的执行处理程序接收一个 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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅