ExternalVideoFrame

C++

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;
};

属性

参数名	描述
`type`	视频类型。详见 VIDEO_BUFFER_TYPE。
`format`	像素格式。详见 VIDEO_PIXEL_FORMAT。
`buffer`	视频帧缓冲区。
`stride`	输入视频帧的行间距，单位为像素而非字节。对于纹理数据，该值为纹理的宽度。
`height`	输入视频帧的高度。
`cropLeft`	从左侧裁剪的像素数。默认值为 0。
`cropTop`	从顶部裁剪的像素数。默认值为 0。
`cropRight`	从右侧裁剪的像素数。默认值为 0。
`cropBottom`	从底部裁剪的像素数。默认值为 0。
`rotation`	视频帧的顺时针旋转角度。可设置为 0、90、180 或 270。默认值为 0。
`timestamp`	输入视频帧的时间戳（毫秒）。时间戳错误会导致帧丢失或音视频不同步。
`eglContext`	仅适用于 Texture 格式的视频数据。使用 Khronos 定义的 OpenGL 接口（javax.microedition.khronos.egl.）时，将该字段设置为 `eglContext`。使用 Android 定义的 OpenGL 接口（android.opengl.）时，也将该字段设置为 `eglContext`。
`eglType`	仅适用于 Texture 格式的视频数据。纹理上下文类型。
`textureId`	仅适用于 Texture 格式的视频数据。视频帧的纹理 ID。
`fenceObject`	仅适用于 Texture 格式的视频数据。与 `textureId` 参数相关的 fence 对象，表示纹理数据的同步状态。默认值为 0。
`matrix`	仅适用于 Texture 格式的视频数据。输入的 4×4 变换矩阵。典型值为单位矩阵。
`alphaBuffer`	输出参数，通过人像分割算法输出的 Alpha 通道数据。该数据与视频帧大小一致，每个像素值范围为 [0, 255]，其中 0 表示背景，255 表示前景（人像）。通过设置该参数，可以将视频背景渲染为透明、纯色、图像、视频等多种效果。
`fillAlphaBuffer`	注：对于 BGRA 或 RGBA 格式的视频数据，可以通过以下任一方式设置 Alpha 通道数据：将该参数设置为 true，自动提取。通过 `alphaBuffer` 参数手动设置。仅适用于 BGRA 或 RGBA 格式的视频数据。是否从视频帧中提取 Alpha 通道数据并自动填充到 `alphaBuffer`： true：提取并填充 Alpha 通道数据。 false：不提取和填充 Alpha 通道数据。
`alphaStitchMode`	当视频帧包含 Alpha 通道数据时，表示 `alphaBuffer` 与视频帧的相对位置。详见 ALPHA_STITCH_MODE。
`d3d11Texture2d`	仅适用于 Windows Texture 格式的视频数据。指向 `ID3D11Texture2D` 类型对象的指针，该对象由视频帧使用。
`textureSliceIndex`	仅适用于 Windows Texture 格式的视频数据。表示视频帧在 `ID3D11Texture2D` 数组中使用的纹理对象的索引。
`colorSpace`	视频帧的色彩空间属性，默认采用 Full Range 和 BT.709 标准配置。详见 `VideoColorSpace`。

旧字段链接

以上锚点仅用于旧文档链接兼容，当前结构体字段列表不包含这两个预览字段。

属性

旧字段链接

咨询电话

咨询电话

属性Copy Anchor Link

旧字段链接Copy Anchor Link

咨询电话

咨询电话

属性

旧字段链接