AgoraVideoFrame
- iOS
更新时间
外部视频帧。
__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注:
strideInPixels:步幅单位为像素,而非字节。- 关于帧的宽度和高度:未定义
width字段,但可以通过以下方式推导:
croppedWidth = (strideInPixels - cropLeft - cropRight)``croppedHeight = (height - cropTop - cropBottom)
- 关于裁剪:如果缓冲区包含无效数据,可以通过裁剪去除。例如,帧大小为 360 x 640,缓冲区步幅为 368,即右侧多出 8 像素用于填充,此时可以设置:
strideInPixels = 368;``height = 640;``cropRight = 8;``// cropLeft、cropTop、cropBottom 默认为 0。
属性
| 参数名 | 描述 |
|---|---|
format | 输入视频帧的格式。该参数必须指定为以下值之一:1:I420;2:BGRA;3:NV21;4:RGBA;5:IMC2;7:ARGB;8:NV12;12:iOS 纹理( |
time | 输入视频帧的时间戳(毫秒)。时间戳错误会导致帧丢失或音视频不同步。 |
stride | 帧的行跨度,即相邻两行视频帧之间的像素数。单位为像素,而非字节。处理视频数据时,需根据此参数处理每行像素数据之间的偏移,否则可能导致图像失真。 注:
|
strideInPixels | 输入视频帧的行间距,单位为像素而非字节。对于纹理格式,该值为纹理的宽度。 注: 不适用于 iOS 纹理。 |
height | 输入视频帧的高度(像素行数)。 注: 不适用于 iOS 纹理。 |
textureBuf | iOS 纹理的缓冲区。 |
image | 静态图像(iPhone 上为 |
dataBuf | 原始数据缓冲区。 注: 不适用于 iOS 纹理。 |
alphaBuf | 当前帧的 Alpha 通道,与视频帧的尺寸一致。每个像素的取值范围为 [0, 255],其中 0 表示背景,255 表示前景。默认值为 nil。 |
alphaStitchMode | Alpha 通道拼接模式,表示 |
cropLeft | 左侧裁剪的像素数。默认值为 0。 |
cropTop | 顶部裁剪的像素数。默认值为 0。 |
cropRight | 右侧裁剪的像素数。默认值为 0。 |
cropBottom | 底部裁剪的像素数。默认值为 0。 |
rotation | 视频帧的顺时针旋转角度。可设置为 0、90、180 或 270。默认值为 0。 注: 详见文档中关于旋转的计算方式。 |
colorSpace | 视频帧的色彩空间配置。默认采用 Full Range 和 BT.709 标准。详见 |