AgoraCameraCapturerConfiguration

摄像头采集配置。

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

（可选）摄像头方向。详见 AgoraCameraDirection。

cameraFocalLengthType

（可选）摄像头的焦距类型。详见 AgoraFocalLength。

注意

• 部分 iOS 设备的后置摄像头为多个摄像头组成的融合镜头，如双摄（广角和超广角）或三摄（广角、超广角和长焦），对于这种具备超广角能力的融合镜头，你可以通过以下任意一种方式实现超广角的采集效果：
  • 方式一：将该参数设置为 AgoraFocalLengthUltraWide (2)（超广角镜头）。
  • 方式二：将该参数设置为 AgoraFocalLengthDefault (0)（标准镜头），然后调用 setCameraZoomFactor: 将相机缩放比例设置为小于 1.0 的数值，最小可以设置为 0.5。
  区别为方式一的超广角大小不可调节，方式二支持自由调节相机的缩放比例。

dimension

（可选）视频帧的分辨率 (px)。默认值为 960 × 540。

frameRate

（可选）视频帧的帧率 (fps)。默认值为 15。

followEncodeDimensionRatio

（可选）是否跟随 setVideoEncoderConfiguration: 中设置的视频宽高比：

• YES：(默认) 跟随。SDK 会将采集到的视频按照已设置的视频宽高比进行裁剪，会同步改变本地预览画面、onCaptureVideoFrame:sourceType: 和 onPreEncodeVideoFrame:sourceType: 中的视频画面。
• NO：不跟随。SDK不改变采集到的视频帧宽高比。