VideoFrame
- Flutter
更新时间
视频帧的属性设置。
@JsonSerializable(explicitToJson: true, includeIfNull: false)
class VideoFrame {
const VideoFrame(
{this.type,
this.width,
this.height,
this.yStride,
this.uStride,
this.vStride,
this.yBuffer,
this.uBuffer,
this.vBuffer,
this.rotation,
this.renderTimeMs,
this.avsyncType,
this.metadataBuffer,
this.metadataSize,
this.textureId,
this.matrix,
this.alphaBuffer,
this.alphaStitchMode,
this.pixelBuffer,
this.metaInfo;
this.colorSpace});
@JsonKey(name: 'type')
final VideoPixelFormat? type;
@JsonKey(name: 'width')
final int? width;
@JsonKey(name: 'height')
final int? height;
@JsonKey(name: 'yStride')
final int? yStride;
@JsonKey(name: 'uStride')
final int? uStride;
@JsonKey(name: 'vStride')
final int? vStride;
@JsonKey(name: 'yBuffer', ignore: true)
final Uint8List? yBuffer;
@JsonKey(name: 'uBuffer', ignore: true)
final Uint8List? uBuffer;
@JsonKey(name: 'vBuffer', ignore: true)
final Uint8List? vBuffer;
@JsonKey(name: 'rotation')
final int? rotation;
@JsonKey(name: 'renderTimeMs')
final int? renderTimeMs;
@JsonKey(name: 'avsync_type')
final int? avsyncType;
@JsonKey(name: 'metadata_buffer', ignore: true)
final Uint8List? metadataBuffer;
@JsonKey(name: 'metadata_size')
final int? metadataSize;
@JsonKey(name: 'textureId')
final int? textureId;
@JsonKey(name: 'matrix')
final List<double>? matrix;
@JsonKey(name: 'alphaBuffer', ignore: true)
final Uint8List? alphaBuffer;
@JsonKey(name: 'alphaStitchMode')
final AlphaStitchMode? alphaStitchMode;
@JsonKey(name: 'pixelBuffer', ignore: true)
final Uint8List? pixelBuffer;
@VideoFrameMetaInfoConverter()
@JsonKey(name: 'metaInfo')
final VideoFrameMetaInfo? metaInfo;
@JsonKey(name: 'colorSpace')
final ColorSpace? colorSpace;
factory VideoFrame.fromJson(Map<String, dynamic> json) =>
_$VideoFrameFromJson(json);
Map<String, dynamic> toJson() => _$VideoFrameToJson(this);
}缓冲区给出的是指向指针的指针,该接口不能修改缓冲区的指针,只能修改缓冲区的内容。
属性
| 参数名 | 描述 |
|---|---|
type | 像素格式。详见 VideoPixelFormat。 |
width | 视频像素宽度。 |
height | 视频像素高度。 |
yStride | 对 YUV 数据,表示 Y 缓冲区的行跨度;对 RGBA 数据,表示总的数据长度。 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 |
uStride | 对 YUV 数据,表示 U 缓冲区的行跨度;对 RGBA 数据,值为 0。 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 |
vStride | 对 YUV 数据,表示 V 缓冲区的行跨度;对 RGBA 数据,值为 0。 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 |
yBuffer | 对 YUV 数据,表示 Y 缓冲区的指针;对 RGBA 数据,表示数据缓冲区。 |
uBuffer | 对 YUV 数据,表示 U 缓冲区的指针;对 RGBA 数据,值为空。 |
vBuffer | 对 YUV 数据,表示 V 缓冲区的指针;对 RGBA 数据,值为空。 |
rotation | 在渲染视频前设置该帧的顺时针旋转角度,目前支持 0 度、90 度、180 度,和 270 度。 |
renderTimeMs | 视频帧被渲染时的 Unix 时间戳(毫秒)。该时间戳可用于指导渲染视频帧。该参数为必填。 |
avsyncType | 保留参数。 |
metadataBuffer | 该参数仅适用于 Texture 格式的视频数据。指 MetaData 的数据缓冲区,默认值为 |
metadataSize | 该参数仅适用于 Texture 格式的视频数据。指 MetaData 的大小,默认值为 |
textureId | 该参数仅适用于 Texture 格式的视频数据。Texture ID。 |
matrix | 该参数仅适用于 Texture 格式的视频数据。为一个输入的 4x4 变换矩阵,典型值为一个单位矩阵。 |
colorSpace | 视频帧的色彩空间属性,默认情况下会应用 Full Range 和 BT.709 标准配置。你可以根据自定义采集、自定义渲染的业务需求进行自定义设置,详见 VideoColorSpace。 |
alphaBuffer | 采用人像分割算法输出的 Alpha 通道数据。该数据跟视频帧的尺寸一致,每个像素点的取值范围为 [0,255],其中 0 代表背景;255 代表前景(人像)。 你可以通过设置该参数,实现将视频背景自渲染为各种效果,例如:透明、纯色、图片、视频等。 注:
|
alphaStitchMode | 当视频帧中包含 Alpha 通道数据时,设置 |
metaInfo | 视频帧中的元信息。该参数需要联系技术支持使用。 |