# AgoraVideoFrame (/zh-CN/api-reference/rtc/macos/class-externalvideoframe)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```objc
__attribute__((visibility("default"))) @interface AgoraVideoFrame : NSObject
@property(assign, nonatomic) NSInteger format;
@property(assign, nonatomic) CMTime time;
@property(assign, nonatomic) int stride DEPRECATED_MSG_ATTRIBUTE("use strideInPixels instead");
@property(assign, nonatomic) int strideInPixels;
@property(assign, nonatomic) int height;
@property(assign, nonatomic) CVPixelBufferRef _Nullable textureBuf;
@property(strong, nonatomic) IMAGE_CLASS * _Nullable image;
@property(strong, nonatomic) NSData *_Nullable dataBuf;
@property(strong, nonatomic) NSData *_Nullable alphaBuf;
@property(assign, nonatomic) AgoraAlphaStitchMode alphaStitchMode;
@property(assign, nonatomic) int cropLeft;
@property(assign, nonatomic) int cropTop;
@property(assign, nonatomic) int cropRight;
@property(assign, nonatomic) int cropBottom;
@property(assign, nonatomic) int rotation;
@property(strong, nonatomic) AgoraColorSpace *_Nullable colorSpace;
@end
```
:::note
注:
1. `strideInPixels`:步幅单位为像素,而非字节。
2. 关于帧的宽度和高度:未定义 `width` 字段,但可以通过以下方式推导:
`croppedWidth = (strideInPixels - cropLeft - cropRight)``croppedHeight = (height - cropTop - cropBottom)`
1. 关于裁剪:如果缓冲区包含无效数据,可以通过裁剪去除。例如,帧大小为 360 x 640,缓冲区步幅为 368,即右侧多出 8 像素用于填充,此时可以设置:
`strideInPixels = 368;``height = 640;``cropRight = 8;``// cropLeft、cropTop、cropBottom 默认为 0。`
:::
## 属性 [#属性]
输入视频帧的格式。该参数必须指定为以下值之一:1:I420;2:BGRA;3:NV21;4:RGBA;5:IMC2;7:ARGB;8:NV12;12:iOS 纹理(`CVPixelBufferRef`);16:I422。
输入视频帧的时间戳(毫秒)。时间戳错误会导致帧丢失或音视频不同步。
帧的行跨度,即相邻两行视频帧之间的像素数。单位为像素,而非字节。处理视频数据时,需根据此参数处理每行像素数据之间的偏移,否则可能导致图像失真。
:::note
注:
- 如果视频为纹理格式,请将此参数设置为纹理的宽度。
- 如果视频帧格式为 12,请勿使用此字段。
:::
输入视频帧的行间距,单位为像素而非字节。对于纹理格式,该值为纹理的宽度。
:::note
注: 不适用于 iOS 纹理。
:::
输入视频帧的高度(像素行数)。
:::note
注: 不适用于 iOS 纹理。
:::
iOS 纹理的缓冲区。
静态图像(iPhone 上为 `UIImage`,macOS 上为 `NSImage`)。
原始数据缓冲区。
:::note
注: 不适用于 iOS 纹理。
:::
当前帧的 Alpha 通道,与视频帧的尺寸一致。每个像素的取值范围为 [0, 255],其中 0 表示背景,255 表示前景。默认值为 nil。
Alpha 通道拼接模式,表示 `alphaBuf` 与视频帧的相对位置。详见 [AgoraAlphaStitchMode](/zh-CN/api-reference/rtc/macos/enum-alphastitchmode)。
左侧裁剪的像素数。默认值为 0。
顶部裁剪的像素数。默认值为 0。
右侧裁剪的像素数。默认值为 0。
底部裁剪的像素数。默认值为 0。
视频帧的顺时针旋转角度。可设置为 0、90、180 或 270。默认值为 0。
:::note
注: 详见文档中关于旋转的计算方式。
:::
视频帧的色彩空间配置。默认采用 Full Range 和 BT.709 标准。详见 [`VideoColorSpace`](https://developer.mozilla.org/en-US/docs/Web/API/VideoColorSpace)。