# VideoCanvas (/zh-CN/api-reference/rtc/android/4.6.0/class-and-enum/classes/class-videocanvas)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```java
public class VideoCanvas {
public int uid;
public int subviewUid;
public static final int RENDER_MODE_HIDDEN = 1;
public static final int RENDER_MODE_FIT = 2;
public static final int RENDER_MODE_ADAPTIVE = 3;
public static final int VIEW_SETUP_MODE_REPLACE = 0;
public static final int VIEW_SETUP_MODE_ADD = 1;
public static final int VIEW_SETUP_MODE_REMOVE = 2;
public View view;
public SurfaceTexture surfaceTexture;
public int renderMode;
public int mirrorMode;
public int setupMode = VIEW_SETUP_MODE_REPLACE;
public int sourceType;
public int mediaPlayerId;
public Rect rect;
public boolean enableAlphaMask;
public int backgroundColor;
public Constants.VideoModulePosition position = Constants.VideoModulePosition.VIDEO_MODULE_POSITION_POST_CAPTURER;
}
```
## 属性 [#属性]
### `uid` [#uid]
发布视频源的用户 ID。
### `subviewUid` [#subviewuid]
在合流视频流中,发布特定子视频流的用户 ID。
### `RENDER_MODE_HIDDEN` [#render_mode_hidden]
隐藏模式:按比例缩放视频,直到视窗被填满(可能会裁剪视频的一部分)。
### `RENDER_MODE_FIT` [#render_mode_fit]
适应模式:按比例缩放视频,直到某一维度匹配视窗边界,未填满区域用黑色填充。
### `RENDER_MODE_ADAPTIVE` [#render_mode_adaptive]
自适应模式。该模式已废弃,声网不推荐使用。
### `VIEW_SETUP_MODE_REPLACE` [#view_setup_mode_replace]
设置视图模式为替换模式,默认值。
### `VIEW_SETUP_MODE_ADD` [#view_setup_mode_add]
设置视图模式为新增视图。
### `VIEW_SETUP_MODE_REMOVE` [#view_setup_mode_remove]
设置视图模式为移除视图。
### `view` [#view]
用于显示视频的视图窗口,必须为 `SurfaceView` 或 `TextureView` 类型。
:::info[注]
在一个 [VideoCanvas](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-videocanvas) 中只能设置 `view` 或 `surfaceTexture`,若同时设置,仅 `view` 生效。
:::
### `surfaceTexture` [#surfacetexture]
提供视频图像的容器。
:::info[注]
在一个 [VideoCanvas](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-videocanvas) 中只能设置 `view` 或 `surfaceTexture`,若同时设置,仅 `view` 生效。
:::
### `renderMode` [#rendermode]
渲染模式:
- RENDER_MODE_HIDDEN (1):隐藏模式。
- RENDER_MODE_FIT (2):适应模式。
- RENDER_MODE_ADAPTIVE (3):自适应模式(已废弃,声网不推荐使用)。
### `mirrorMode` [#mirrormode]
注:
- 本地视频视图镜像模式:使用前置摄像头时默认开启,后置摄像头时默认关闭。
- 远端用户默认关闭镜像模式。
镜像模式:
- VIDEO_MIRROR_MODE_AUTO (0):SDK 自动判断是否开启镜像模式。
- VIDEO_MIRROR_MODE_ENABLED (1):开启本地视图镜像模式。
- VIDEO_MIRROR_MODE_DISABLED (2):关闭本地视图镜像模式。
### `setupMode` [#setupmode]
:::info[注]
不再使用视图时建议将 `setupMode` 设置为 `VIEW_SETUP_MODE_REMOVE`,以防止渲染资源泄漏。
:::
视图设置模式:
- VIEW_SETUP_MODE_REPLACE (0):替换视图,默认值。
- VIEW_SETUP_MODE_ADD (1):新增视图。
- VIEW_SETUP_MODE_REMOVE (2):删除视图。
### `sourceType` [#sourcetype]
视频源类型。详见 [VideoSourceType](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-videosourcetype)。
### `mediaPlayerId` [#mediaplayerid]
媒体播放器的 ID。
### `rect` [#rect]
视频帧的显示区域。 `width` 和 `height` 表示该区域的视频像素宽高。默认值为 `null` (宽或高为 0),表示显示视频帧的实际分辨率。详见 `Rect`。
### `enableAlphaMask` [#enablealphamask]
是否启用 Alpha 遮罩渲染:
- true:启用。
- false:不启用。
该功能可实现透明图像效果,从视频中提取人像,结合其他功能可实现画中画、水印等效果。
### `backgroundColor` [#backgroundcolor]
视频画布的背景颜色,RGBA 格式。默认值为 0x00000000,表示黑色。
注:
- 如果使用 Kotlin 开发并设置为 0xFFFFFFFF 时出现编译错误,可使用 (0xFFFFFFFF).toInt() 或 android.graphics.Color.parseColor("#FFFFFFFF")。
- 当前使用 RGBA 格式时不支持 Alpha 通道。
### `position` [#position]
视频帧在视频链路中的观察位置。详见 [VideoModulePosition](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-videomoduleposition)。