VideoFrame

视频帧的属性设置。

Dart

@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.pixelBuffer});
  @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: 'pixelBuffer', ignore: true)
  final Uint8List? pixelBuffer;
  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 的数据缓冲区，默认值为 NULL。

metadataSize

该参数仅适用于 Texture 格式的视频数据。指 MetaData 的大小，默认值为 0。

textureId

该参数仅适用于 Texture 格式的视频数据。Texture ID。

matrix

该参数仅适用于 Texture 格式的视频数据。为一个输入的 4x4 变换矩阵，典型值为一个单位矩阵。

metaInfo

视频帧中的元信息。该参数需要联系技术支持使用。