# LocalVideoStats (/zh-CN/api-reference/rtc/android/class-localvideostats)

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

<a id="class_localvideostats__prototype"></a>

```java
public static class LocalVideoStats {
    public int uid;
    public int sentBitrate;
    public int sentFrameRate;
    public int captureFrameRate;
    public int captureFrameWidth;
    public int captureFrameHeight;
    public int regulatedCaptureFrameRate;
    public int regulatedCaptureFrameWidth;
    public int regulatedCaptureFrameHeight;
    public int encoderOutputFrameRate;
    public int rendererOutputFrameRate;
    public int targetBitrate;
    public int targetFrameRate;
    public int qualityAdaptIndication;
    public int encodedBitrate;
    public int encodedFrameWidth;
    public int encodedFrameHeight;
    public int encodedFrameCount;
    public int codecType;
    public int txPacketLossRate;
    public int captureBrightnessLevel;
    public boolean dualStreamEnabled;
    public int hwEncoderAccelerating;
    public int encodedFrameDepth;
}
```

<a id="class_localvideostats__parameters"></a>

## 属性 [#属性]

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

本地用户的用户 ID。

</Parameter>
<a id="sentbitrate"></a>
<Parameter name="sentBitrate">

本地视频流在发送过程中的实际码率（Kbps）。

:::note
注： 该值不包括由于丢包引起的重传码率。
:::

</Parameter>
<a id="sentframerate"></a>
<Parameter name="sentFrameRate">

本地视频流在发送过程中的实际帧率（fps）。

:::note
注： 该值不包括由于丢包引起的重传帧率。
:::

</Parameter>
<a id="captureframerate"></a>
<Parameter name="captureFrameRate">

采集本地视频流时的帧率（fps）。

</Parameter>
<a id="captureframewidth"></a>
<Parameter name="captureFrameWidth">

采集本地视频流时的宽度（px）。

</Parameter>
<a id="captureframeheight"></a>
<Parameter name="captureFrameHeight">

采集本地视频流时的高度（px）。

</Parameter>
<a id="regulatedcaptureframerate"></a>
<Parameter name="regulatedCaptureFrameRate">

声网 SDK 内建的视频采集调节器根据编码配置调整后的本地视频帧率（fps）。

</Parameter>
<a id="regulatedcaptureframewidth"></a>
<Parameter name="regulatedCaptureFrameWidth">

声网 SDK 内建的视频采集调节器根据编码配置调整后的本地视频宽度（px）。

</Parameter>
<a id="regulatedcaptureframeheight"></a>
<Parameter name="regulatedCaptureFrameHeight">

声网 SDK 内建的视频采集调节器根据编码配置调整后的本地视频高度（px）。

</Parameter>
<a id="encoderoutputframerate"></a>
<Parameter name="encoderOutputFrameRate">

本地视频编码器的输出帧率（fps）。

</Parameter>
<a id="rendereroutputframerate"></a>
<Parameter name="rendererOutputFrameRate">

本地视频渲染器的输出帧率（fps）。

</Parameter>
<a id="targetbitrate"></a>
<Parameter name="targetBitrate">

当前编码器的目标码率（Kbps）。

:::note
注： 该值由 SDK 根据当前网络状况估算得出。
:::

</Parameter>
<a id="targetframerate"></a>
<Parameter name="targetFrameRate">

当前编码器的目标帧率（fps）。

</Parameter>
<a id="qualityadaptindication"></a>
<Parameter name="qualityAdaptIndication">

本地视频流在统计周期内的画质自适应状态：

- `ADAPT_NONE` (0)：本地视频质量维持不变。
- `ADAPT_UP_BANDWIDTH` (1)：由于网络带宽增加，本地视频质量上升。
- `ADAPT_DOWN_BANDWIDTH` (2)：由于网络带宽下降，本地视频质量下降。

</Parameter>
<a id="encodedbitrate"></a>
<Parameter name="encodedBitrate">

对本地视频流编码时的码率（Kbps）。

:::note
注： 该值不包括由于丢包引起的重传码率。
:::

</Parameter>
<a id="encodedframewidth"></a>
<Parameter name="encodedFrameWidth">

编码后视频的宽度（px）。

</Parameter>
<a id="encodedframeheight"></a>
<Parameter name="encodedFrameHeight">

编码后视频的高度（px）。

</Parameter>
<a id="encodedframecount"></a>
<Parameter name="encodedFrameCount">

发送的视频帧总数，表示为聚合值。

</Parameter>
<a id="codectype"></a>
<Parameter name="codecType">

:::note
注： 在某些场景下（如采集分辨率较低或设备性能有限），SDK 会自动切换为 H.264 编码格式。
:::

本地视频使用的编码器类型。可选值如下，详见 [VIDEO_CODEC_TYPE](/zh-CN/api-reference/rtc/android/enum-videocodectype)：

- `VIDEO_CODEC_VP8` (1)：VP8。
- `VIDEO_CODEC_H264` (2)：H.264。
- `VIDEO_CODEC_H265` (3)：H.265（默认）。

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

应用抗丢包策略前，本地客户端到声网服务器的视频丢包率（%）。

</Parameter>
<a id="capturebrightnesslevel"></a>
<Parameter name="captureBrightnessLevel">

:::note
注： 等待几秒后，可从下一次回调中的 `captureBrightnessLevel` 获取亮度等级。
:::

本地摄像头采集的视频画面的亮度等级：

- `CAPTURE_BRIGHTNESS_LEVEL_INVALID` (-1)：SDK 未检测到画面亮度。
- `CAPTURE_BRIGHTNESS_LEVEL_NORMAL` (0)：画面亮度正常。
- `CAPTURE_BRIGHTNESS_LEVEL_BRIGHT` (1)：画面亮度过亮。
- `CAPTURE_BRIGHTNESS_LEVEL_DARK` (2)：画面亮度过暗。

</Parameter>
<a id="dualstreamenabled"></a>
<Parameter name="dualStreamEnabled">

是否启用了双流功能：

- true：启用双流功能。
- false：未启用双流功能。

</Parameter>
<a id="hwencoderaccelerating"></a>
<Parameter name="hwEncoderAccelerating">

本地视频编码加速类型：

- 0：使用软件编码，无加速。
- 1：使用硬件编码进行加速。

</Parameter>
</ParameterList>