# 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/)开通。
:::