# VideoLayout (/zh-CN/api-reference/rtc/cpp-all-platforms/class-videolayout)

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

<a id="class_videolayout__prototype"></a>

```cpp
struct VideoLayout {
  const char* channelId;
  rtc::uid_t uid;
  user_id_t strUid;
  uint32_t x;
  uint32_t y;
  uint32_t width;
  uint32_t height;
  uint32_t videoState;
};
```

<a id="class_videolayout__detailed_desc"></a>

描述混流中某个子视频流在合流画布中的位置、尺寸和显示状态。

<a id="class_videolayout__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="channelid"></a>
<Parameter name="channelId">

子视频流所属的频道名。

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

发布该子视频流的用户 ID。

</Parameter>
<a id="struid"></a>
<Parameter name="strUid">

预留参数。

</Parameter>
<a id="x"></a>
<Parameter name="x">

子视频流在合流画布上的 X 坐标（像素），表示视频左上角相对于画布左上角的水平偏移。

</Parameter>
<a id="y"></a>
<Parameter name="y">

子视频流在合流画布上的 Y 坐标（像素），表示视频左上角相对于画布左上角的垂直偏移。

</Parameter>
<a id="width"></a>
<Parameter name="width">

子视频流的宽度（像素）。

</Parameter>
<a id="height"></a>
<Parameter name="height">

子视频流的高度（像素）。

</Parameter>
<a id="videostate"></a>
<Parameter name="videoState">

子视频流在合流画布上的显示状态：

- `0`：正常，子视频流已渲染到画布上。
- `1`：占位图像，子视频流无视频帧，在画布上显示为占位图。
- `2`：黑色图像，子视频流被黑色图像替代。

</Parameter>
</ParameterList>