@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/{doc → knowledge}/trtc/android/TRTCStatistics.md

@@ -1,18 +1,20 @@
-# 腾讯云实时音视频(TRTC SDK )文档
+Copyright (c) 2021 Tencent. All rights reserved.
 
-## 概述
-`TRTCStatistics.java` 是腾讯云实时音视频(TRTC SDK ) Android 平台的统计指标（只读）文档，TRTC SDK 会以两秒钟一次的频率向您汇报当前实时的音视频指标（帧率、码率、卡顿情况等）。
+Module:   TRTC 音视频统计指标（只读）
+
+Function: TRTC SDK 会以两秒钟一次的频率向您汇报当前实时的音视频指标（帧率、码率、卡顿情况等）
 
 ## 结构体类型
-| 函数列表 | 描述 |
-| --- | --- |
-| TRTCLocalStatistics | 本地的音视频统计指标。 |
-| TRTCRemoteStatistics | 远端的音视频统计指标。 |
-| TRTCStatistics | 网络和性能的汇总统计指标。 |
+
+|函数列表|描述|
+|---------|---------|
+|TRTCLocalStatistics|本地的音视频统计指标。|
+|TRTCRemoteStatistics|远端的音视频统计指标。|
+|TRTCStatistics|网络和性能的汇总统计指标。|
 
 ## TRTCLocalStatistics
 
-#### 本地的音视频统计指标。
+**本地的音视频统计指标。**
 | 枚举类型 | 描述 |
 | --- | --- |
 | audioBitrate | 【字段含义】本地音频的码率，即每秒钟新产生音频数据的多少，单位 Kbps。 |
@@ -26,13 +28,13 @@
 
 ## TRTCRemoteStatistics
 
-#### 远端的音视频统计指标。
+**远端的音视频统计指标。**
 | 枚举类型 | 描述 |
 | --- | --- |
-| audioBitrate | 【字段含义】本地音频的码率，单位 Kbps |
+| audioBitrate | 【字段含义】远端音频的码率，单位 Kbps |
 | audioBlockRate | 【字段含义】音频播放卡顿率，单位 (%)<br>音频播放卡顿率（audioBlockRate） = 音频播放的累计卡顿时长（audioTotalBlockTime） / 音频播放的总时长 |
-| audioPacketLoss | 【字段含义】音频流的总丢包率（％）。<br>audioPacketLoss 代表音频流历经“主播>云端>观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。<br>audioPacketLoss 越小越好，丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。<br>如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况，说明该路音频流在“云端=>观众”这一段链路上没有出现丢包，但是在` 主播>云端 `这一段链路上出现了不可恢复的丢包。 |
-| audioSampleRate | 【字段含义】本地音频的采样率，单位 Hz。 |
+| audioPacketLoss | 【字段含义】音频流的总丢包率（％）。<br>audioPacketLoss 代表音频流历经“主播>云端>观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。<br>audioPacketLoss 越小越好，丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。<br>如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况，说明该路音频流在“云端=>观众”这一段链路上没有出现丢包，但是在<code> 主播>云端 </code>这一段链路上出现了不可恢复的丢包。 |
+| audioSampleRate | 【字段含义】远端音频的采样率，单位 Hz。 |
 | audioTotalBlockTime | 【字段含义】音频播放的累计卡顿时长，单位 ms |
 | finalLoss | 【字段含义】该路音视频流的总丢包率（％）。已废弃，不推荐使用；建议使用 audioPacketLoss、videoPacketLoss 替代。 |
 | frameRate | 【字段含义】远端视频的帧率，单位：FPS。 |
@@ -51,12 +53,12 @@
 
 ## TRTCStatistics
 
-#### 网络和性能的汇总统计指标。
+**网络和性能的汇总统计指标。**
 | 枚举类型 | 描述 |
 | --- | --- |
 | appCpu | 【字段含义】当前应用的 CPU 使用率，单位 (%)，Android 8.0 以上不支持。 |
 | downLoss | 【字段含义】从云端到 SDK 的下行丢包率，单位 (%)<br>该数值越小越好，如果 downLoss 为 0%，则意味着下行链路的网络质量很好，从云端接收的数据包基本不发生丢失。<br>如果 downLoss 为 30%，则意味着云端向 SDK 传输的音视频数据包中，会有 30% 丢失在传输链路中。 |
-| gatewayRtt | 【字段含义】从 SDK 到本地路由器的往返时延，单位 ms 该数值代表从 SDK 发送一个网络包到本地路由器网关，再从网关回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 【SDK>网关>SDK【 的总耗时。<br>该数值越小越好：如果 gatewayRtt < 50ms，意味着较低的音视频通话延迟；如果 gatewayRtt > 200ms，则意味着较高的音视频通话延迟。<br>当网络类型为蜂窝网时，该值无效。 |
+| gatewayRtt | 【字段含义】从 SDK 到本地路由器的往返时延，单位 ms 该数值代表从 SDK 发送一个网络包到本地路由器网关，再从网关回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK=>网关=>SDK” 的总耗时。<br>该数值越小越好：如果 gatewayRtt < 50ms，意味着较低的音视频通话延迟；如果 gatewayRtt > 200ms，则意味着较高的音视频通话延迟。<br>当网络类型为蜂窝网时，该值无效。 |
 | localArray | 【字段含义】本地的音视频统计信息<br>由于本地可能有三路音视频流（即高清大画面，低清小画面，以及辅流画面），因此本地的音视频统计信息是一个数组。 |
 | receiveBytes | 【字段含义】总接收字节数（包含信令数据和音视频数据），单位：字节数（Bytes）。 |
 | remoteArray | 【字段含义】远端的音视频统计信息<br>因为同时可能有多个远端用户，而且每个远端用户同时可能有多路音视频流（即高清大画面，低清小画面，以及辅流画面），因此远端的音视频统计信息是一个数组。 |