# agora::ExternalVideoFrame结构体 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1-external-video-frame) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 详细描述 [#详细描述] [ExternalVideoFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1-external-video-frame) 结构体。 ## 成员枚举类型说明 [#成员枚举类型说明] ### VIDEO_BUFFER_TYPE [#video_buffer_type] enum [agora::ExternalVideoFrame::VIDEO_BUFFER_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1-external-video-frame#a0d5010576e24646b2135d50e3e07dda7) 视频类型。 枚举值 VIDEO_BUFFER_RAW_DATA 1: 原始数据。 VIDEO_BUFFER_ARRAY 2: 与 VIDEO_BUFFER_RAW_DATA 相同。 VIDEO_BUFFER_TEXTURE 3: Texture 格式的视频缓冲。 ## 构造及析构函数说明 [#构造及析构函数说明] ### ExternalVideoFrame() [#externalvideoframe] agora::ExternalVideoFrame::ExternalVideoFrame() ## 类成员变量说明 [#类成员变量说明] ### type [#type] [VIDEO_BUFFER_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1-external-video-frame#a0d5010576e24646b2135d50e3e07dda7) agora::ExternalVideoFrame::type 视频类型: [VIDEO_BUFFER_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1-external-video-frame#a0d5010576e24646b2135d50e3e07dda7)。 ### format [#format] [VIDEO_PIXEL_FORMAT](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a08597f4fe6a0ef1ad7b53538fd27d119) agora::ExternalVideoFrame::format 像素格式: [VIDEO_PIXEL_FORMAT](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a08597f4fe6a0ef1ad7b53538fd27d119)。 ### buffer [#buffer] void* agora::ExternalVideoFrame::buffer 视频缓冲区。 ### stride [#stride] int agora::ExternalVideoFrame::stride 传入视频帧的行间距,单位为像素而不是字节。对于 Texture,该值指的是 Texture 的宽度。 ### height [#height] int agora::ExternalVideoFrame::height 传入视频帧的高度。 ### cropLeft [#cropleft] int agora::ExternalVideoFrame::cropLeft [原始数据相关字段] 指定左边裁剪掉的像素数量。默认为 0。 ### cropTop [#croptop] int agora::ExternalVideoFrame::cropTop [原始数据相关字段] 指定顶边裁剪掉的像素数量。默认为 0。 ### cropRight [#cropright] int agora::ExternalVideoFrame::cropRight [原始数据相关字段] 指定右边裁剪掉的像素数量。默认为 0。 ### cropBottom [#cropbottom] int agora::ExternalVideoFrame::cropBottom [原始数据相关字段] 指定底边裁剪掉的像素数量。默认为 0。 ### rotation [#rotation] int agora::ExternalVideoFrame::rotation [原始数据相关字段] 指定是否对传入的视频组做顺时针旋转操作,可选值为 0, 90, 180, 270。默认为 0。 ### timestamp [#timestamp] long long agora::ExternalVideoFrame::timestamp 传入的视频帧的时间戳,以毫秒为单位。不正确的时间戳会导致丢帧或者音视频不同步。 ### alphaBuffer [#alphabuffer] uint8_t* agora::ExternalVideoFrame::alphaBuffer 表示人像分割算法的输出数据,跟视频帧的尺寸一致。每个像素点的取值范围为 [0,255],其中 0 表示背景;255 代表前景(人像)。 在用户自定义视频渲染场景下,该参数可帮助实现将视频背景自渲染为各种效果,例如:透明、纯色、图片、视频等等。 :::info[注解] 该参数需要[联系技术支持](https://ticket.shengwang.cn/)开通。 :::