AgoraCameraCapturerConfiguration

  • iOS

更新时间不可用

设置摄像头采集偏好。

Objective-C
__attribute__((visibility("default"))) @interface AgoraCameraCapturerConfiguration: NSObject
#if TARGET_OS_IOS
@property (assign, nonatomic) AgoraCameraDirection cameraDirection;
@property(assign, nonatomic) AgoraFocalLength cameraFocalLengthType;
#elif TARGET_OS_MAC
@property (copy, nonatomic) NSString * _Nullable deviceId;
#endif
@property(assign, nonatomic) CGSize dimensions;
@property(assign, nonatomic) int frameRate;
@property(assign, nonatomic) BOOL followEncodeDimensionRatio;
@end

属性

参数名描述
cameraDirection

摄像头方向,仅适用于 iOS。详见 AgoraCameraDirection。

cameraFocalLengthType

摄像头焦距类型,仅适用于 iOS。详见 AgoraFocalLength。

注: 对于配备多镜头后置摄像头的 iOS 设备(如双摄像头:广角和超广角,或三摄像头:广角、超广角和长焦),你可以使用以下任一方式以超广角视角采集视频:

  • 方法一:将该参数设置为 AgoraFocalLengthUltraWide(2)(超广角镜头)。
  • 方法二:将该参数设置为 AgoraFocalLengthDefault(0)(标准镜头),然后调用 setCameraZoomFactor: 将摄像头的缩放因子设置为小于 1.0 的值,最小值为 0.5。

两种方法的区别在于,方法一的超广角尺寸不可调节,而方法二支持自由调节摄像头的缩放因子。

deviceId

摄像头设备 ID,仅适用于 macOS。

dimensions

视频帧的尺寸(单位:像素)。默认值为 960 × 540。

frameRate

视频帧的帧率(单位:fps)。默认值为 15。

followEncodeDimensionRatio

是否遵循通过 setVideoEncoderConfiguration 设置的视频宽高比。

  • YES:(默认)遵循设置的视频宽高比。SDK 会根据设置的视频宽高比裁剪采集的视频,并同步更新本地预览画面以及 onCaptureVideoFrame 和 onPreEncodeVideoFrame 中的视频帧。
  • NO:不遵循设置的视频宽高比。SDK 不会更改采集视频帧的宽高比。
表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?