# ExternalVideoFrame (/zh-CN/api-reference/rtc/cpp-all-platforms/class-externalvideoframe) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```cpp struct ExternalVideoFrame { VIDEO_BUFFER_TYPE type; VIDEO_PIXEL_FORMAT format; void* buffer; int stride; int height; int cropLeft; int cropTop; int cropRight; int cropBottom; int rotation; long long timestamp; void* eglContext; EGL_CONTEXT_TYPE eglType; int textureId; long long fenceObject; float matrix[16]; uint8_t* alphaBuffer; bool fillAlphaBuffer; ALPHA_STITCH_MODE alphaStitchMode; void *d3d11Texture2d; int textureSliceIndex; ColorSpace colorSpace; }; ``` ## 属性 [#属性] 视频类型。详见 [VIDEO_BUFFER_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videobuffertype)。 像素格式。详见 [VIDEO_PIXEL_FORMAT](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-videopixelformat)。 视频帧缓冲区。 输入视频帧的行间距,单位为像素而非字节。对于纹理数据,该值为纹理的宽度。 输入视频帧的高度。 从左侧裁剪的像素数。默认值为 0。 从顶部裁剪的像素数。默认值为 0。 从右侧裁剪的像素数。默认值为 0。 从底部裁剪的像素数。默认值为 0。 视频帧的顺时针旋转角度。可设置为 0、90、180 或 270。默认值为 0。 输入视频帧的时间戳(毫秒)。时间戳错误会导致帧丢失或音视频不同步。 仅适用于 Texture 格式的视频数据。 - 使用 Khronos 定义的 OpenGL 接口(javax.microedition.khronos.egl.*)时,将该字段设置为 `eglContext`。 - 使用 Android 定义的 OpenGL 接口(android.opengl.*)时,也将该字段设置为 `eglContext`。 仅适用于 Texture 格式的视频数据。纹理上下文类型。 仅适用于 Texture 格式的视频数据。视频帧的纹理 ID。 仅适用于 Texture 格式的视频数据。与 `textureId` 参数相关的 fence 对象,表示纹理数据的同步状态。默认值为 0。 仅适用于 Texture 格式的视频数据。输入的 4×4 变换矩阵。典型值为单位矩阵。 输出参数,通过人像分割算法输出的 Alpha 通道数据。该数据与视频帧大小一致,每个像素值范围为 [0, 255],其中 0 表示背景,255 表示前景(人像)。通过设置该参数,可以将视频背景渲染为透明、纯色、图像、视频等多种效果。 :::note 注: 对于 BGRA 或 RGBA 格式的视频数据,可以通过以下任一方式设置 Alpha 通道数据: - 将该参数设置为 true,自动提取。 - 通过 `alphaBuffer` 参数手动设置。 ::: 仅适用于 BGRA 或 RGBA 格式的视频数据。是否从视频帧中提取 Alpha 通道数据并自动填充到 `alphaBuffer`: - true:提取并填充 Alpha 通道数据。 - false:不提取和填充 Alpha 通道数据。 当视频帧包含 Alpha 通道数据时,表示 `alphaBuffer` 与视频帧的相对位置。详见 [ALPHA_STITCH_MODE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-alphastitchmode)。 仅适用于 Windows Texture 格式的视频数据。指向 `ID3D11Texture2D` 类型对象的指针,该对象由视频帧使用。 仅适用于 Windows Texture 格式的视频数据。表示视频帧在 `ID3D11Texture2D` 数组中使用的纹理对象的索引。 视频帧的色彩空间属性,默认采用 Full Range 和 BT.709 标准配置。详见 [`VideoColorSpace`](https://developer.mozilla.org/en-US/docs/Web/API/VideoColorSpace)。 ## 旧字段链接 [#旧字段链接] 以上锚点仅用于旧文档链接兼容,当前结构体字段列表不包含这两个预览字段。