# RtcStats (/zh-CN/api-reference/rtc/unreal-cpp/class-rtcstats)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_rtcstats__prototype"></a>

```cpp
struct RtcStats {
  unsigned int duration;
  unsigned int txBytes;
  unsigned int rxBytes;
  unsigned int txAudioBytes;
  unsigned int txVideoBytes;
  unsigned int rxAudioBytes;
  unsigned int rxVideoBytes;
  unsigned short txKBitRate;
  unsigned short rxKBitRate;
  unsigned short rxAudioKBitRate;
  unsigned short txAudioKBitRate;
  unsigned short rxVideoKBitRate;
  unsigned short txVideoKBitRate;
  unsigned short lastmileDelay;
  unsigned int userCount;
  double cpuAppUsage;
  double cpuTotalUsage;
  int gatewayRtt;
  double memoryAppUsageRatio;
  double memoryTotalUsageRatio;
  int memoryAppUsageInKbytes;
  int connectTimeMs;
  int txPacketLossRate;
  int rxPacketLossRate;
  RtcStats() :
      duration(0),
      txBytes(0),
      rxBytes(0),
      txAudioBytes(0),
      txVideoBytes(0),
      rxAudioBytes(0),
      rxVideoBytes(0),
      txKBitRate(0),
      rxKBitRate(0),
      rxAudioKBitRate(0),
      txAudioKBitRate(0),
      rxVideoKBitRate(0),
      txVideoKBitRate(0),
      lastmileDelay(0),
      userCount(0),
      cpuAppUsage(0.0),
      cpuTotalUsage(0.0),
      gatewayRtt(0),
      memoryAppUsageRatio(0.0),
      memoryTotalUsageRatio(0.0),
      memoryAppUsageInKbytes(0),
      connectTimeMs(0),
      txPacketLossRate(0),
      rxPacketLossRate(0) {}
};
```

<a id="class_rtcstats__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="duration"></a>
<Parameter name="duration">

本地用户通话时长（秒），累计值。

</Parameter>
<a id="txbytes"></a>
<Parameter name="txBytes">

发送字节数 (bytes)。

</Parameter>
<a id="rxbytes"></a>
<Parameter name="rxBytes">

接收字节数 (bytes)。

</Parameter>
<a id="txaudiobytes"></a>
<Parameter name="txAudioBytes">

发送音频字节数 (bytes)，累计值。

</Parameter>
<a id="txvideobytes"></a>
<Parameter name="txVideoBytes">

发送视频字节数 (bytes)，累计值。

</Parameter>
<a id="rxaudiobytes"></a>
<Parameter name="rxAudioBytes">

接收音频字节数 (bytes)，累计值。

</Parameter>
<a id="rxvideobytes"></a>
<Parameter name="rxVideoBytes">

接收视频字节数 (bytes)，累计值。

</Parameter>
<a id="txkbitrate"></a>
<Parameter name="txKBitRate">

发送码率 (Kbps)。

</Parameter>
<a id="rxkbitrate"></a>
<Parameter name="rxKBitRate">

接收码率 (Kbps)。

</Parameter>
<a id="rxaudiokbitrate"></a>
<Parameter name="rxAudioKBitRate">

音频接收码率 (Kbps)。

</Parameter>
<a id="txaudiokbitrate"></a>
<Parameter name="txAudioKBitRate">

音频包的发送码率 (Kbps)。

</Parameter>
<a id="rxvideokbitrate"></a>
<Parameter name="rxVideoKBitRate">

视频接收码率 (Kbps)。

</Parameter>
<a id="txvideokbitrate"></a>
<Parameter name="txVideoKBitRate">

视频发送码率 (Kbps)。

</Parameter>
<a id="lastmiledelay"></a>
<Parameter name="lastmileDelay">

客户端-接入服务器延时 (毫秒)。

</Parameter>
<a id="txpacketlossrate"></a>
<Parameter name="txPacketLossRate">

使用抗丢包技术前，客户端上行发送到服务器丢包率 (%)。

</Parameter>
<a id="rxpacketlossrate"></a>
<Parameter name="rxPacketLossRate">

使用抗丢包技术前，服务器下行发送到客户端丢包率 (%)。

</Parameter>
<a id="usercount"></a>
<Parameter name="userCount">

当前频道内的用户人数。

</Parameter>
<a id="cpuappusage"></a>
<Parameter name="cpuAppUsage">

当前 App 的 CPU 使用率 (%)。

:::caution
注意：

- [onLeaveChannel](/zh-CN/api-reference/rtc/unreal-cpp/channel#callback_irtcengineeventhandler_onleavechannel) 回调中报告的 cpuAppUsage 恒为 0。
- 自 Android 8.1 起，因系统限制，你可能无法通过该属性获取 CPU 使用率。
:::

</Parameter>
<a id="cputotalusage"></a>
<Parameter name="cpuTotalUsage">

当前系统的 CPU 使用率 (%)。

对于 Windows 平台，在多核环境中，该成员指多核 CPU 的平均使用率。 计算方式为 (100 - 任务管理中显示的系统空闲进程 CPU)/100。

:::caution
注意：

- [onLeaveChannel](/zh-CN/api-reference/rtc/unreal-cpp/channel#callback_irtcengineeventhandler_onleavechannel) 回调中报告的 cpuTotalUsage 恒为 0。
- 自 Android 8.1 起，因系统限制，你无法通过该属性获取 CPU 使用率。
:::

</Parameter>
<a id="connecttimems"></a>
<Parameter name="connectTimeMs">

从开始建立连接到成功连接的时间（毫秒）。如报告 0，则表示无效。

</Parameter>
<a id="gatewayrtt"></a>
<Parameter name="gatewayRtt">

客户端到本地路由器的往返时延 (ms)。

:::note
注：

该属性默认在 iOS 14 之前的设备上开启，在 iOS 14 及之后的设备上关闭。

如需在 iOS 14 及之后的设备上启用该属性，请[联系技术支持](https://ticket.shengwang.cn/)。
:::

:::note
注： 在 Android 平台上，如需获取 gatewayRtt，请确保已在项目 `AndroidManifest.xml` 文件的 `</application>` 后面添加 `android.permission.ACCESS_WIFI_STATE` 权限。
:::

</Parameter>
<a id="memoryappusageratio"></a>
<Parameter name="memoryAppUsageRatio">

当前 App 的内存占比 (%)。

:::caution
注意： 该值仅作参考。受系统限制可能无法获取。
:::

</Parameter>
<a id="memorytotalusageratio"></a>
<Parameter name="memoryTotalUsageRatio">

当前系统的内存占比 (%)。

:::caution
注意： 该值仅作参考。受系统限制可能无法获取。
:::

</Parameter>
<a id="memoryappusageinkbytes"></a>
<Parameter name="memoryAppUsageInKbytes">

当前 App 的内存大小 (KB)。

:::caution
注意： 该值仅作参考。受系统限制可能无法获取。
:::

</Parameter>
</ParameterList>