---
title: RTCStatsReport
slug: Web/API/RTCStatsReport
translation_of: Web/API/RTCStatsReport
---
<p>{{APIRef("WebRTC")}}</p>

<p>{{draft("该页面目前尚不完整，正在建设中。 请注意，它还不能解答您所有的问题。")}}</p>

<p><span class="seoSummary"><code><strong>RTCStatsReport</strong></code> 接口提供了通过调用 {{domxref("RTCPeerConnection.getStats()")}}, {{domxref("RTCRtpReceiver.getStats()")}}，和 {{domxref("RTCRtpSender.getStats()")}} 这三个方法之一所获得的统计报告。该统计报告包含统计类别字符串名称到包含相应统计数据的对象的映射。</span></p>

<p>在 {{domxref("RTCPeerConnection")}} 上调用 <code>getStats()</code> 可以指定是希望获取连接上的出站，入站还是所有流的统计信息。 <code>getStats()</code> 的 {{domxref("RTCRtpReceiver")}} 和 {{domxref("RTCRtpSender")}} 版本仅返回可用于调用它们的传入或传出流的统计信息。</p>

<h2 id="统计对象">统计对象</h2>

<p>对于每种统计信息类别，都有一个字典，字典的属性提供相关信息。</p>

<h3 id="所有统计类别共有的属性">所有统计类别共有的属性</h3>

<p>所有 WebRTC 统计对象都基于 {{domxref("RTCStats")}} 字典，该字典提供了最基本的信息：时间戳，统计类型字符串和唯一标识数据源的ID：</p>

<p>{{page("/en-US/docs/Web/API/RTCStats", "Properties")}}</p>

<h3 id="统计类别">统计类别</h3>

<p>{{domxref("RTCStats.type", "type")}} 给出了对象所代表的统计类别的名称，以及如何查找所需的特定数据类型。统计类别名称是枚举类 {{domxref("RTCStatsType")}} 的成员，如下所示：</p>

<p>{{page("/en-US/docs/Web/API/RTCStatsType", "Values")}}</p>

<h2 id="使用_RTCStatsReport">使用 RTCStatsReport</h2>

<p><em>... 即将到来 ...</em></p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">标准</th>
   <th scope="col">状态</th>
   <th scope="col">说明</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('WebRTC 1.0', '#rtcstatsreport-object', 'RTCStatsReport') }}</td>
   <td>{{ Spec2('WebRTC 1.0') }}</td>
   <td>初始规范</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("api.RTCStatsReport")}}</p>

<h2 id="参见">参见</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/WebRTC_API">WebRTC API</a></li>
 <li>{{domxref("RTCPeerConnection")}}</li>
 <li>{{domxref("RTCPeerConnection.getStats()")}}, {{domxref("RTCRtpReceiver.getStats()")}}, and {{domxref("RTCRtpSender.getStats()")}}</li>
</ul>