# VideoFrame (/zh-CN/api-reference/rtc/flutter/class-videoframe) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```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.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? 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 json) => _$VideoFrameFromJson(json); Map toJson() => _$VideoFrameToJson(this); } ``` 缓冲区给出的是指向指针的指针,该接口不能修改缓冲区的指针,只能修改缓冲区的内容。 ## 属性 [#属性] 像素格式。详见 [VideoPixelFormat](/zh-CN/api-reference/rtc/flutter/enum-videopixelformat)。 视频像素宽度。 视频像素高度。 对 YUV 数据,表示 Y 缓冲区的行跨度;对 RGBA 数据,表示总的数据长度。 :::note 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 ::: 对 YUV 数据,表示 U 缓冲区的行跨度;对 RGBA 数据,值为 0。 :::note 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 ::: 对 YUV 数据,表示 V 缓冲区的行跨度;对 RGBA 数据,值为 0。 :::note 注: 在处理视频数据时,需根据该参数处理每行像素数据之间的偏移量,否则可能导致图像失真。 ::: 对 YUV 数据,表示 Y 缓冲区的指针;对 RGBA 数据,表示数据缓冲区。 对 YUV 数据,表示 U 缓冲区的指针;对 RGBA 数据,值为空。 对 YUV 数据,表示 V 缓冲区的指针;对 RGBA 数据,值为空。 在渲染视频前设置该帧的顺时针旋转角度,目前支持 0 度、90 度、180 度,和 270 度。 视频帧被渲染时的 Unix 时间戳(毫秒)。该时间戳可用于指导渲染视频帧。该参数为必填。 保留参数。 该参数仅适用于 Texture 格式的视频数据。指 MetaData 的数据缓冲区,默认值为 `NULL`。 该参数仅适用于 Texture 格式的视频数据。指 MetaData 的大小,默认值为 `0`。 该参数仅适用于 Texture 格式的视频数据。Texture ID。 该参数仅适用于 Texture 格式的视频数据。为一个输入的 4x4 变换矩阵,典型值为一个单位矩阵。 视频帧的色彩空间属性,默认情况下会应用 Full Range 和 BT.709 标准配置。你可以根据自定义采集、自定义渲染的业务需求进行自定义设置,详见 [VideoColorSpace](https://developer.mozilla.org/en-US/docs/Web/API/VideoColorSpace)。 采用人像分割算法输出的 Alpha 通道数据。该数据跟视频帧的尺寸一致,每个像素点的取值范围为 [0,255],其中 0 代表背景;255 代表前景(人像)。 你可以通过设置该参数,实现将视频背景自渲染为各种效果,例如:透明、纯色、图片、视频等。 :::note 注: - 在自定义视频渲染场景下,需确保传入的视频帧和 `alphaBuffer` 均为 Full Range 类型;其他类型可能导致 Alpha 数据渲染不正常。 - 请务必确保 `alphaBuffer` 跟视频帧的尺寸 (width × height) 完全一致,否则可能会导致 App 崩溃。 ::: 当视频帧中包含 Alpha 通道数据时,设置 `alphaBuffer` 和视频帧的相对位置。详见 [AlphaStitchMode](/zh-CN/api-reference/rtc/flutter/enum-alphastitchmode)。 视频帧中的元信息。该参数需要[联系技术支持](https://ticket.shengwang.cn/)使用。