AgoraCameraCapturer 类

Inherits from NSObject
Declared in AgoraStreamingKit.h

概览

AgoraCameraCapturer 接口。(仅适用于 iOS 平台)

该接口中包含管理摄像头采集行为的方法。采集行为的设置会影响本地用户和远端用户所见。

  cameraPosition

摄像头方向,详见 AgoraCameraPosition

@property (nonatomic, assign) AgoraCameraPosition cameraPosition

详情

Note: 该属性仅适用于 iOS 平台。

Declared In

AgoraStreamingKit.h

– setCameraFocusPositionInPreview:

设置手动对焦。(仅适用于 iOS 平台)

- (BOOL)setCameraFocusPositionInPreview:(CGPoint)position

参数

position

触摸点相对于视图的坐标。

返回

  • YES: 方法调用成功
  • NO: 方法调用失败

详情

调用 isCameraFocusPositionInPreviewSupported 确认设备的摄像头支持手动对焦后, 你可以调用本方法指定摄像头对焦的位置并进行手动对焦。

如果你希望摄像头对人脸进行自动对焦,你可以调用 setCameraAutoFocusFaceModeEnabled

Note: 该方法需在摄像头启动后调用。

Declared In

AgoraStreamingKit.h

– setCameraAutoFocusFaceModeEnabled:

设置是否开启人脸自动对焦。(仅适用于 iOS 平台)

- (BOOL)setCameraAutoFocusFaceModeEnabled:(BOOL)enable

参数

enable

是否开启人脸自动对焦:

  • YES: 开启人脸自动对焦。
  • NO:(默认)关闭人脸自动对焦。

返回

  • YES: 方法调用成功
  • NO: 方法调用失败

详情

调用 isCameraAutoFocusFaceModeSupported 确认设备的摄像头支持人脸自动对焦后, 你可以调用本方法开启/关闭人脸自动对焦功能。

如果你希望进行手动对焦,你可以调用 setCameraFocusPositionInPreview

Note: 该方法需在摄像头启动后调用。

Declared In

AgoraStreamingKit.h

– setCameraZoomFactor:

设置摄像头变焦倍数。(仅适用于 iOS 平台)

- (BOOL)setCameraZoomFactor:(CGFloat)zoomFactor

参数

zoomFactor

变焦倍数。取值范围为 1.0 到 getMaxZoom 返回的最大变焦倍数。

返回

  • YES: 方法调用成功
  • NO: 方法调用失败

详情

如果你需要放大摄像头采集的视频图像,请依次进行如下操作:

  • 调用 isCameraZoomSupported 确认设备摄像头是否支持变焦。
  • 调用 getMaxZoom 获取摄像头支持的最大变焦倍数。
  • 调用本方法,设置合适的变焦倍数以放大采集的视频图像。

Declared In

AgoraStreamingKit.h

– getMaxZoom

获取设备摄像头支持的最大变焦倍数。(仅适用于 iOS 平台)

- (float)getMaxZoom

返回

设备摄像头支持的最大变焦倍数。

详情

调用 isCameraZoomSupported 确认设备的摄像头支持变焦后,你可以调用本方法获取摄像头支持的最大变焦倍数。

Declared In

AgoraStreamingKit.h

– isCameraZoomSupported

检查设备摄像头是否支持变焦。(仅适用于 iOS 平台)

- (BOOL)isCameraZoomSupported

返回

  • YES: 设备摄像头支持变焦。
  • NO: 设备摄像头不支持变焦。

Declared In

AgoraStreamingKit.h

– isCameraFocusPositionInPreviewSupported

检查设备摄像头是否支持手动对焦。(仅适用于 iOS 平台)

- (BOOL)isCameraFocusPositionInPreviewSupported

返回

  • YES: 设备摄像头支持手动对焦。
  • NO: 设备摄像头不支持手动对焦。

Declared In

AgoraStreamingKit.h

– isCameraAutoFocusFaceModeSupported

检查设备摄像头是否支持人脸自动对焦。(仅适用于 iOS 平台)

- (BOOL)isCameraAutoFocusFaceModeSupported

返回

  • YES: 设备摄像头支持人脸自动对焦。
  • NO: 设备摄像头不支持人脸自动对焦。

Declared In

AgoraStreamingKit.h