ZegoCamera Class Reference

Inherits from	NSObject
Declared in	zego-api-camera-oc.h

`+ setCamExposurePoint:channelIndex:`

设置设备坐标中的曝光参考点 (Deprecated: 请使用 [setCamExposurePointInPreview:channelIndex:] 代替)

+ (BOOL)setCamExposurePoint:(CGPoint)point channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`point`	坐标点的 x 和 y 的取值范围均为 [0.0, 1.0]. 坐标是对应于设备的归一化的坐标, 左上角坐标为 (0.0, 0.0)，右下角坐标为(1.0, 1.0)
`index`	推流通道 @attention 必须在初始化 SDK 后调用

Declared In

zego-api-camera-oc.h

`+ setCamFocusPointInPreview:channelIndex:`

设置预览视图中的对焦点

+ (BOOL)setCamFocusPointInPreview:(CGPoint)point channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`point`	坐标点的 x 和 y 的取值范围均为 [0.0, 1.0]. 坐标是对应于视图的归一化的坐标，左上角是(0.0, 0.0), 右下角是 (1.0, 1.0)
`index`	推流通道

Return Value

true 成功，false 失败 @attention 每次摄像头重新启动采集，设置都会失效，需要重新设置. @attention 如果要使用对焦功能最好关闭人脸识别，目前 iOS 是默认开启的, 通过 setConfig 接口设置 “camera_detect_face=false” 关闭.

Declared In

zego-api-camera-oc.h

`+ setCamExposurePointInPreview:channelIndex:`

设置预览视图中的曝光参考点

+ (BOOL)setCamExposurePointInPreview:(CGPoint)point channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`point`	坐标点的 x 和 y 的取值范围均为 [0.0, 1.0]. 坐标是对应于视图的归一化的坐标，左上角是(0.0, 0.0), 右下角是 (1.0, 1.0)
`index`	推流通道

Return Value

true 成功，false 失败 @attention 每次摄像头重新启动采集，设置都会失效，需要重新设置.

Declared In

zego-api-camera-oc.h

`+ setCamZoomFactor:channelIndex:`

设置摄像头变焦倍数

+ (BOOL)setCamZoomFactor:(float)zoomFactor channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`zoomFactor`	变焦倍数，最小值为1.0，最大值不能超过 getCamMaxZoomFactor: 的返回值
`index`	推流通道

Return Value

true 成功，false 失败 @attention 每次摄像头重新启动采集，设置都会失效，需要重新设置.

Declared In

zego-api-camera-oc.h

`+ getCamMaxZoomFactor:`

获取摄像头最大变焦倍数

+ (float)getCamMaxZoomFactor:(ZegoAPIPublishChannelIndex)index

Parameters

`index`	推流通道

Return Value

返回最大变焦倍数，1.0为不支持变焦

Declared In

zego-api-camera-oc.h

`+ setCamExposureCompensation:channelIndex:`

设置曝光补偿度

+ (BOOL)setCamExposureCompensation:(float)value channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`value`	曝光度，取值范围为[-1,1], -1变黑, 1变亮
`index`	推流通道

Return Value

true 成功，false 失败

Discussion

必须在初始化 SDK 后调用

Declared In

zego-api-camera-oc.h

`+ setCamFocusMode:channelIndex:`

设置对焦模式

+ (BOOL)setCamFocusMode:(ZegoCameraFocusMode)mode channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`mode`	对焦模式，参考 ZegoCameraFocusMode
`index`	推流 channel Index. 默认为主Channel

Return Value

true 成功，false 失败 @attention 必须在初始化 SDK 后调用 @attention 仅对后摄像头生效 @attention SDK 默认使用 ZegoCameraFocusModeContinuousAutoFocus

Declared In

zego-api-camera-oc.h

`+ setCamExposureMode:channelIndex:`

设置曝光模式

+ (BOOL)setCamExposureMode:(ZegoCameraExposureMode)mode channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`mode`	曝光模式，参考 ZegoCameraExposureMode
`index`	推流 channel Index. 默认为主Channel

Return Value

true 成功，false 失败 @attention 必须在初始化 SDK 后调用 @attention SDK 默认使用 ZegoCameraExposureModeContinuousAutoExposure

Declared In

zego-api-camera-oc.h

`+ enableCamAdaptiveFPS:minFPS:maxFPS:channelIndex:`

开启摄像头自适应帧率

+ (void)enableCamAdaptiveFPS:(BOOL)enable minFPS:(int)minFPS maxFPS:(int)maxFPS channelIndex:(ZegoAPIPublishChannelIndex)index

Parameters

`enable`	true 开启，false 关闭
`minFPS`	期望帧率的最小值，最小值为 3，建议 15
`maxFPS`	期望帧率的最大值，非负值，建议 25
`index`	推流通道

Discussion

Note: 开启后，SDK 在一定帧率范围内根据环境亮度自动匹配合适的摄像头帧率，提升设置的帧率过高时的画面亮度。

Note: 业务场景：推流端用户设置的帧率偏高，所处环境光照较低，无法正常显示或识别主体的场景。

@attention 调用时机：在初始化 SDK 后、摄像头启动前调用。 @attention 注意事项：当 SetVideoFPS 设置帧率值小于期望帧率最小值时，将使用 SetVideoFPS 设置的帧率值。

Declared In

zego-api-camera-oc.h