# io.agora.rtc.ExternalVideoFrame类 参考 (/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-external-video-frame) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ExternalVideoFrame 类。 ## 类成员变量说明 [#类成员变量说明] ### alphaBuffer [#alphabuffer] ByteBuffer io.agora.rtc.ExternalVideoFrame.alphaBuffer 采用人像分割算法输出的 Alpha 通道数据。该数据跟视频帧的尺寸一致,每个像素点的取值范围为 [0,255],其中 0 代表背景;255 代表前景(人像)。你可以通过设置该参数,实现将视频背景自渲染为各种效果,例如:透明、纯色、图片、视频等。 ### alphaMode [#alphamode] int io.agora.rtc.ExternalVideoFrame.alphaMode 当视频祯中包含 Alpha 通道数据时,设置 alphaBuffer 和视频祯的相对位置: - 0: (默认)仅视频祯,即 alphaBuffer 不和视频祯拼接。 - 1: alphaBuffer 位于视频帧的上方。 - 2: alphaBuffer 位于视频帧的下方。 - 3: alphaBuffer 位于视频帧的左侧。 - 4: alphaBuffer 位于视频帧的右侧。 ### buffer [#buffer] java.nio.ByteBuffer io.agora.rtc.ExternalVideoFrame.buffer 视频 buffer。 ### colorSpace [#colorspace] ColorSpace io.agora.rtc.ExternalVideoFrame.colorSpace 视频帧的色彩空间属性,默认情况下会应用 Full Range 和 BT.709 标准配置。你可以根据自定义采集、自定义渲染的业务需求进行自定义设置,详见 [ColorSpaceType](https://developer.mozilla.org/en-US/docs/Web/API/VideoColorSpace)。 ### cropBottom [#cropbottom] int io.agora.rtc.ExternalVideoFrame.cropBottom [原始数据相关字段] 指定底边裁剪掉的像素数量。默认为 0。 ### cropLeft [#cropleft] int io.agora.rtc.ExternalVideoFrame.cropLeft [原始数据相关字段] 指定左边裁剪掉的像素数量。默认为 0。 ### cropRight [#cropright] int io.agora.rtc.ExternalVideoFrame.cropRight [原始数据相关字段] 指定右边裁剪掉的像素数量。默认为 0。 ### cropTop [#croptop] int io.agora.rtc.ExternalVideoFrame.cropTop [原始数据相关字段] 指定顶边裁剪掉的像素数量。默认为 0。 ### eglContext [#eglcontext] Object io.agora.rtc.ExternalVideoFrame.eglContext 该参数仅适用于 Texture 格式的视频数据。 - 当使用 Khronos 定义的 OpenGL 接口 (javax.microedition.khronos.egl.*)时,需要将 eglContext 设置给这个字段。 - 当使用 Android 定义的 OpenGL 接口 (android.opengl.*)时,需要将 eglContext 设置给这个字段。 ### eglType [#egltype] int io.agora.rtc.ExternalVideoFrame.eglType EGL 类型。该参数仅适用于 Texture 格式的视频数据。 ### fillAlphaBuffer [#fillalphabuffer] int io.agora.rtc.ExternalVideoFrame.fillAlphaBuffer 该参数仅适用于 BGRA 或 RGBA 格式的视频数据。设置提取视频祯中的 Alpha 通道数据并自动填入到 alphaBuffer 中。 - true: 提取并填充 Alpha 通道数据。 - false: (默认)不提取填充 Alpha 通道数据。 对于 BGRA 或 RGBA 格式的视频数据,你可以任选一种方式设置 Alpha 通道数据: - 通过将该参数设置为 true 自动填写。 - 通过 alphaBuffer 参数设置。 ### format [#format] int io.agora.rtc.ExternalVideoFrame.format 像素格式。 ### height [#height] int io.agora.rtc.ExternalVideoFrame.height 传入视频帧的高度。 ### matrix [#matrix] float io.agora.rtc.ExternalVideoFrame.matrix 该参数仅适用于 Texture 格式的视频数据。为一个输入的 4x4 变换矩阵,典型值为一个单位矩阵。 ### metadataBuffer [#metadatabuffer] ByteBuffer io.agora.rtc.ExternalVideoFrame.metadataBuffer 该参数仅适用于 Texture 格式的视频数据。指 MetaData 的数据缓冲区,默认值为 nil。 ### rotation [#rotation] int io.agora.rtc.ExternalVideoFrame.rotation [原始数据相关字段] 指定是否对传入的视频组做顺时针旋转操作,可选值为 0,90,180,270。默认为 0。 ### stride [#stride] int io.agora.rtc.ExternalVideoFrame.stride 传入视频帧的行间距(像素)。对于 Texture,该值指的是 Texture 的宽度。 ### textureId [#textureid] int io.agora.rtc.ExternalVideoFrame.textureId 该帧的 Texture ID。该参数仅适用于 Texture 格式的视频数据。 ### timestamp [#timestamp] long io.agora.rtc.ExternalVideoFrame.timestamp 传入的视频帧的时间戳(毫秒)。不正确的时间戳会导致丢帧或者音视频不同步。 ### type [#type] int io.agora.rtc.ExternalVideoFrame.type 视频帧的数据类型。 - 1:视频帧类型为原始数据。 - 2:与 1 相同。 - 3:视频帧类型为 Texture。 --- 该类的文档由以下文件生成: - ExternalVideoFrame.java