capture_session.h
概述
声明捕获会话概念。
引用文件： <ohcamera/capture_session.h>
库： libohcamera.so
系统能力： SystemCapability.Multimedia.Camera.Core
起始版本： 11
相关模块： OH_Camera
汇总
结构体
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| CaptureSession_Callbacks | CaptureSession_Callbacks | 捕获会话的回调。 |
| Camera_CaptureSession | Camera_CaptureSession | 捕获会话对象。 可以使用OH_CameraManager_CreateCaptureSession方法创建指针。 |
函数
函数说明
OH_CaptureSession_OnFocusStateChange()
typedef void (*OH_CaptureSession_OnFocusStateChange)(Camera_CaptureSession* session, Camera_FocusState focusState)
描述
在CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_FocusState focusState | 回调传递的会话焦点状态。 |
OH_CaptureSession_OnError()
typedef void (*OH_CaptureSession_OnError)(Camera_CaptureSession* session, Camera_ErrorCode errorCode)
描述
在CaptureSession_Callbacks中被调用的捕获会话错误回调。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_ErrorCode errorCode | 捕获会话的错误码。 |
参考：
OH_CaptureSession_OnSmoothZoomInfo()
typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session, Camera_SmoothZoomInfo* smoothZoomInfo)
描述
拍照会话平滑变焦信息回调，触发平滑变焦后该回调会返回。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_SmoothZoomInfo* smoothZoomInfo | 回调传递的平滑变焦参数信息。 |
OH_CaptureSession_OnAutoDeviceSwitchStatusChange()
typedef void (*OH_CaptureSession_OnAutoDeviceSwitchStatusChange)(Camera_CaptureSession* session, Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo)
描述
捕获会话设备切换状态回调。
起始版本： 13
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_AutoDeviceSwitchStatusInfo* autoDeviceSwitchStatusInfo | 回调传递的设备切换状态信息。 |
OH_CaptureSession_OnSystemPressureLevelChange()
typedef void (*OH_CaptureSession_OnSystemPressureLevelChange)(Camera_CaptureSession* session, Camera_SystemPressureLevel systemPressureLevel)
描述
捕获系统压力状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_SystemPressureLevel systemPressureLevel | 回调传递的系统压力等级。 |
OH_CaptureSession_OnControlCenterEffectStatusChange()
typedef void (*OH_CaptureSession_OnControlCenterEffectStatusChange)(Camera_CaptureSession* session, Camera_ControlCenterStatusInfo* controlCenterStatusInfo)
描述
相机控制器效果激活状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| Camera_ControlCenterStatusInfo* controlCenterStatusInfo | 回调传递的相机控制器效果激活状态。 |
OH_CaptureSession_RegisterCallback()
Camera_ErrorCode OH_CaptureSession_RegisterCallback(Camera_CaptureSession* session, CaptureSession_Callbacks* callback)
描述
注册捕获会话事件回调。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| CaptureSession_Callbacks* callback | 要注册的捕获会话事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterCallback(Camera_CaptureSession* session, CaptureSession_Callbacks* callback)
描述
注销捕获会话事件回调。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| CaptureSession_Callbacks* callback | 要注销的捕获会话事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_RegisterSmoothZoomInfoCallback()
Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)
描述
注册平滑变焦信息事件回调。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback | 要注册的平滑变焦信息事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterSmoothZoomInfoCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)
描述
注销平滑变焦信息事件回调。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback | 要注销的平滑变焦信息事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_SetSessionMode()
Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode)
描述
设置会话模式。
此接口不能在OH_CaptureSession_BeginConfig之后使用。
建议在使用OH_CameraManager_CreateCaptureSession后立即使用此接口。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_SceneMode sceneMode | 相机模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 |
OH_CaptureSession_AddSecureOutput()
Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)
描述
把其中一条PreviewOutput标记成安全输出。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreviewOutput* previewOutput | 要标记为安全输出的Camera_PreviewOutput。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 |
OH_CaptureSession_BeginConfig()
Camera_ErrorCode OH_CaptureSession_BeginConfig(Camera_CaptureSession* session)
描述
开始捕获会话配置。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。 |
OH_CaptureSession_CommitConfig()
Camera_ErrorCode OH_CaptureSession_CommitConfig(Camera_CaptureSession* session)
描述
提交捕获会话配置。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_AddInput()
Camera_ErrorCode OH_CaptureSession_AddInput(Camera_CaptureSession* session, Camera_Input* cameraInput)
描述
添加相机输入。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Input* cameraInput | 要添加的相机输入实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_RemoveInput()
Camera_ErrorCode OH_CaptureSession_RemoveInput(Camera_CaptureSession* session, Camera_Input* cameraInput)
描述
删除相机输入。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Input* cameraInput | 要删除的相机输入实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_AddPreviewOutput()
Camera_ErrorCode OH_CaptureSession_AddPreviewOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)
描述
添加预览输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreviewOutput* previewOutput | 要添加的预览输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_RemovePreviewOutput()
Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)
描述
删除预览输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreviewOutput* previewOutput | 要删除的预览输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_AddPhotoOutput()
Camera_ErrorCode OH_CaptureSession_AddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)
描述
添加拍照输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PhotoOutput* photoOutput | 要添加的拍照输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_RemovePhotoOutput()
Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* photoOutput)
描述
删除拍照输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PhotoOutput* photoOutput | 要删除的拍照输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_AddVideoOutput()
Camera_ErrorCode OH_CaptureSession_AddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)
描述
添加录像输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoOutput* videoOutput | 要添加的录像输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_RemoveVideoOutput()
Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)
描述
删除录像输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoOutput* videoOutput | 要删除的录像输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_AddMetadataOutput()
Camera_ErrorCode OH_CaptureSession_AddMetadataOutput(Camera_CaptureSession* session, Camera_MetadataOutput* metadataOutput)
描述
添加元数据输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_MetadataOutput* metadataOutput | 要添加的元数据输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_RemoveMetadataOutput()
Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput(Camera_CaptureSession* session, Camera_MetadataOutput* metadataOutput)
描述
删除元数据输出。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_MetadataOutput* metadataOutput | 要删除的元数据输出实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 |
OH_CaptureSession_Start()
Camera_ErrorCode OH_CaptureSession_Start(Camera_CaptureSession* session)
描述
启动捕获会话。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 要启动的Camera_CaptureSession实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_Stop()
Camera_ErrorCode OH_CaptureSession_Stop(Camera_CaptureSession* session)
描述
停止捕获会话。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 要停止的Camera_CaptureSession实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_Release()
Camera_ErrorCode OH_CaptureSession_Release(Camera_CaptureSession* session)
描述
释放捕获会话。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 要释放的Camera_CaptureSession实例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_HasFlash()
Camera_ErrorCode OH_CaptureSession_HasFlash(Camera_CaptureSession* session, bool* hasFlash)
描述
检查设备是否有闪光灯。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool* hasFlash | 是否支持闪光灯的结果。返回true表示支持闪光灯，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsFlashModeSupported()
Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported(Camera_CaptureSession* session, Camera_FlashMode flashMode, bool* isSupported)
描述
检查是否支持指定的闪光灯模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FlashMode flashMode | 要检查的闪光灯模式。 |
| bool* isSupported | 是否支持闪光灯模式的结果。返回true表示支持闪光灯模式，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetFlashMode()
Camera_ErrorCode OH_CaptureSession_GetFlashMode(Camera_CaptureSession* session, Camera_FlashMode* flashMode)
描述
获取当前闪光灯模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FlashMode* flashMode | 当前闪光灯模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetFlashMode()
Camera_ErrorCode OH_CaptureSession_SetFlashMode(Camera_CaptureSession* session, Camera_FlashMode flashMode)
描述
设置闪光灯模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FlashMode flashMode | 要设置的闪光灯模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_OnFlashStateChange()
typedef void (*OH_CaptureSession_OnFlashStateChange)(const Camera_CaptureSession* session, OH_Camera_FlashState flashState)
描述
捕获会话闪光灯状态变更回调。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | 传递回调的Camera_CaptureSession指针。 |
| OH_Camera_FlashState flashState | 回调传递的闪光灯状态。 |
OH_CaptureSession_RegisterFlashStateChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterFlashStateChangeCallback(const Camera_CaptureSession* session, OH_CaptureSession_OnFlashStateChange flashStateChange)
描述
注册闪光灯状态变更事件回调。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_CaptureSession_OnFlashStateChange flashStateChange | 待注册的闪光灯状态变更回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 |
OH_CaptureSession_UnregisterFlashStateChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterFlashStateChangeCallback(const Camera_CaptureSession* session, OH_CaptureSession_OnFlashStateChange flashStateChange)
描述
注销闪光灯状态变更回调。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_CaptureSession_OnFlashStateChange flashStateChange | 待注销的闪光灯状态变更回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 |
OH_CaptureSession_IsExposureModeSupported()
Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported(Camera_CaptureSession* session, Camera_ExposureMode exposureMode, bool* isSupported)
描述
检查是否支持指定的曝光模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_ExposureMode exposureMode | 要检查的曝光模式。 |
| bool* isSupported | 是否支持曝光模式的结果。返回true表示支持曝光模式，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetExposureMode()
Camera_ErrorCode OH_CaptureSession_GetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode* exposureMode)
描述
获取当前曝光模式。如果未通过OH_CaptureSession_SetExposureMode接口进行设置，则直接调用该接口查询当前曝光模式，会返回无效值。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_ExposureMode* exposureMode | 当前的曝光模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetExposureMode()
Camera_ErrorCode OH_CaptureSession_SetExposureMode(Camera_CaptureSession* session, Camera_ExposureMode exposureMode)
描述
设置曝光模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_ExposureMode exposureMode | 要设置的曝光模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetMeteringPoint()
Camera_ErrorCode OH_CaptureSession_GetMeteringPoint(Camera_CaptureSession* session, Camera_Point* point)
描述
获取当前测量点。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Point* point | 当前测量点。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetMeteringPoint()
Camera_ErrorCode OH_CaptureSession_SetMeteringPoint(Camera_CaptureSession* session, Camera_Point point)
描述
设置计量区域的中心点。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Point point | 要设置的测量点。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsExposureMeteringModeSupported()
Camera_ErrorCode OH_CaptureSession_IsExposureMeteringModeSupported(const Camera_CaptureSession* session, OH_Camera_ExposureMeteringMode exposureMeteringMode, bool* isSupported)
描述
查询指定曝光测光模式是否支持。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_ExposureMeteringMode exposureMeteringMode | 待检查的曝光测光模式。 |
| bool* isSupported | 输出参数，返回曝光模式是否支持的结果。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetExposureMeteringMode()
Camera_ErrorCode OH_CaptureSession_GetExposureMeteringMode(const Camera_CaptureSession* session, OH_Camera_ExposureMeteringMode* exposureMeteringMode)
描述
获取当前曝光测光模式。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_ExposureMeteringMode* exposureMeteringMode | 输出参数，返回当前曝光测光模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetExposureMeteringMode()
Camera_ErrorCode OH_CaptureSession_SetExposureMeteringMode(const Camera_CaptureSession* session, OH_Camera_ExposureMeteringMode exposureMeteringMode)
描述
设置曝光测光模式。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_ExposureMeteringMode exposureMeteringMode | 待设置的目标曝光测光模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedISORange()
Camera_ErrorCode OH_CaptureSession_GetSupportedISORange(const Camera_CaptureSession* session, int32_t *minIsoValue, int32_t *maxIsoValue)
描述
查询ISO感光度范围。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t *minIsoValue | 输出参数，返回ISO最小值。 |
| int32_t *maxIsoValue | 输出参数，返回ISO最大值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetIso()
Camera_ErrorCode OH_CaptureSession_GetIso(const Camera_CaptureSession* session, int32_t* isoValue)
描述
获取当前ISO感光度值（遵循ISO 12232:2006标准）。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| int32_t* isoValue | 输出参数，返回当前ISO感光度值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetIso()
Camera_ErrorCode OH_CaptureSession_SetIso(const Camera_CaptureSession* session, int32_t isoValue)
描述
设置ISO感光度值。需在OH_CaptureSession_GetSupportedISORange获取到的范围内进行设置，且仅曝光模式为EXPOSURE_MODE_LOCKED时生效。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| int32_t isoValue | 待设置的目标ISO值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedPhysicalApertures()
Camera_ErrorCode OH_CaptureSession_GetSupportedPhysicalApertures(const Camera_CaptureSession* session, OH_Camera_PhysicalAperture** apertures, uint32_t* size)
描述
获取支持的物理光圈列表。调用OH_CaptureSession_DeletePhysicalApertures删除支持的物理光圈列表。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_Camera_PhysicalAperture** apertures | 用于存储物理光圈值的数组指针。 |
| uint32_t* size | 输出物理光圈数组大小。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_DeletePhysicalApertures()
Camera_ErrorCode OH_CaptureSession_DeletePhysicalApertures(const Camera_CaptureSession* session, OH_Camera_PhysicalAperture* apertures, uint32_t size)
描述
删除支持的物理光圈列表。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_PhysicalAperture* apertures | 待删除的物理光圈数组指针。 |
| uint32_t size | 物理光圈数组大小。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_GetPhysicalAperture()
Camera_ErrorCode OH_CaptureSession_GetPhysicalAperture(const Camera_CaptureSession* session, double* aperture)
描述
获取当前物理光圈值。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| double* aperture | 输出参数，返回当前光圈值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetPhysicalAperture()
Camera_ErrorCode OH_CaptureSession_SetPhysicalAperture(const Camera_CaptureSession* session, double aperture)
描述
设置物理光圈值。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| double aperture | 待设置的光圈值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetExposureBiasRange()
Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange(Camera_CaptureSession* session, float* minExposureBias, float* maxExposureBias, float* step)
描述
查询曝光补偿范围。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* minExposureBias | 曝光补偿的最小值。 |
| float* maxExposureBias | 曝光补偿的最大值。 |
| float* step | 每个级别之间的曝光补偿阶梯。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetExposureBias()
Camera_ErrorCode OH_CaptureSession_SetExposureBias(Camera_CaptureSession* session, float exposureBias)
描述
设置曝光补偿。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float exposureBias | 要设置的曝光补偿。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetExposureBias()
Camera_ErrorCode OH_CaptureSession_GetExposureBias(Camera_CaptureSession* session, float* exposureBias)
描述
获取当前曝光补偿。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* exposureBias | 当前的曝光补偿。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedExposureDurationRange()
Camera_ErrorCode OH_CaptureSession_GetSupportedExposureDurationRange(const Camera_CaptureSession* session, int32_t* minExposureDuration, int32_t* maxExposureDuration)
描述
获取支持的曝光时间范围。单位：微秒。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| int32_t* minExposureDuration | 输出参数，返回曝光时间最小值。 |
| int32_t* maxExposureDuration | 输出参数，返回曝光时间最大值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetExposureDuration()
Camera_ErrorCode OH_CaptureSession_SetExposureDuration(const Camera_CaptureSession* session, int32_t exposureDuration)
描述
设置曝光时间。单位：微秒。若传感器无法精确使用该曝光时间，系统会自动调整为最近的支持值，并通过OH_CaptureSession_OnExposureDurationChange回调通知。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| int32_t exposureDuration | 待设置的目标曝光时间。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetExposureDuration()
Camera_ErrorCode OH_CaptureSession_GetExposureDuration(const Camera_CaptureSession* session, int32_t* exposureDuration)
描述
获取当前曝光时间。单位：微秒。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| int32_t* exposureDuration | 输出参数，返回当前曝光时间。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_OnExposureDurationChange()
typedef void (*OH_CaptureSession_OnExposureDurationChange)(const Camera_CaptureSession* session, int32_t exposureDuration)
描述
捕获会话曝光时间变更回调。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | 传递回调的Camera_CaptureSession指针。 |
| int32_t exposureDuration | 回调传递的曝光时间。 |
OH_CaptureSession_RegisterExposureInfoChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterExposureInfoChangeCallback(const Camera_CaptureSession* session, OH_CaptureSession_OnExposureDurationChange exposureDurationChange)
描述
注册曝光信息变更事件回调，曝光参数变更后系统会返回更新后的曝光信息。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_CaptureSession_OnExposureDurationChange exposureDurationChange | 待注册的曝光时间变更回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 |
OH_CaptureSession_UnregisterExposureInfoChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterExposureInfoChangeCallback(const Camera_CaptureSession* session, OH_CaptureSession_OnExposureDurationChange exposureDurationChange)
描述
注销曝光信息变更回调，相机操作完成后调用该方法。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_CaptureSession_OnExposureDurationChange exposureDurationChange | 待注销的曝光时间变更回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 |
OH_CaptureSession_IsFocusModeSupported()
Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported(Camera_CaptureSession* session, Camera_FocusMode focusMode, bool* isSupported)
描述
检查是否支持指定的聚焦模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FocusMode focusMode | 要检查的聚焦模式。 |
| bool* isSupported | 是否支持聚焦模式的结果。返回true表示支持聚焦模式，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetFocusMode()
Camera_ErrorCode OH_CaptureSession_GetFocusMode(Camera_CaptureSession* session, Camera_FocusMode* focusMode)
描述
获取当前聚焦模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FocusMode* focusMode | 当前聚焦模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetFocusMode()
Camera_ErrorCode OH_CaptureSession_SetFocusMode(Camera_CaptureSession* session, Camera_FocusMode focusMode)
描述
设置聚焦模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_FocusMode focusMode | 要设置的聚焦模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetFocusPoint()
Camera_ErrorCode OH_CaptureSession_GetFocusPoint(Camera_CaptureSession* session, Camera_Point* focusPoint)
描述
获取当前焦点。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Point* focusPoint | 当前焦点。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetFocusPoint()
Camera_ErrorCode OH_CaptureSession_SetFocusPoint(Camera_CaptureSession* session, Camera_Point focusPoint)
描述
设置焦点。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Point focusPoint | 要设置的目标点。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetZoomRatioRange()
Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange(Camera_CaptureSession* session, float* minZoom, float* maxZoom)
描述
获取所有支持的缩放比例范围。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* minZoom | 缩放比范围的最小值。 |
| float* maxZoom | 缩放比例范围的最大值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetZoomRatio()
Camera_ErrorCode OH_CaptureSession_GetZoomRatio(Camera_CaptureSession* session, float* zoom)
描述
获取当前缩放比例。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* zoom | 当前缩放比例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetZoomRatio()
Camera_ErrorCode OH_CaptureSession_SetZoomRatio(Camera_CaptureSession* session, float zoom)
描述
设置缩放比例。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float zoom | 要设置的目标缩放比。 设置可变焦距比到底层生效需要一定时间，获取正确设置的可变焦距比需要等待1~2帧的时间。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsVideoStabilizationModeSupported()
Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported(Camera_CaptureSession* session, Camera_VideoStabilizationMode mode, bool* isSupported)
描述
检查是否支持指定的录像防抖模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoStabilizationMode mode | 要检查的录像防抖模式。 |
| bool* isSupported | 是否支持录像防抖模式的结果。返回true表示支持录像防抖模式，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetVideoStabilizationMode()
Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode(Camera_CaptureSession* session, Camera_VideoStabilizationMode* mode)
描述
获取当前录像防抖模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoStabilizationMode* mode | 当前录像防抖模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetVideoStabilizationMode()
Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode(Camera_CaptureSession* session, Camera_VideoStabilizationMode mode)
描述
设置录像防抖模式。
起始版本： 11
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoStabilizationMode mode | 要设置的录像防抖模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_CanAddInput()
Camera_ErrorCode OH_CaptureSession_CanAddInput(Camera_CaptureSession* session, Camera_Input* cameraInput, bool* isSuccessful)
描述
确定是否可以将相机输入添加到会话中。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_Input* cameraInput | 要设置的相机输入实例。 |
| bool* isSuccessful | 是否可以将相机输入添加到会话中的结果。返回true表示可以将相机输入添加到会话中，返回false表示不可以。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_CanAddPreviewOutput()
Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session, Camera_PreviewOutput* cameraOutput, bool* isSuccessful)
描述
确定是否可以将相机预览输出添加到会话中。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreviewOutput* cameraOutput | 要设置的预览输出实例。 |
| bool* isSuccessful | 是否可以将相机预览输出添加到会话中的结果。返回true表示可以将相机预览输出添加到会话中，返回false表示不可以。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_CanAddPhotoOutput()
Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* cameraOutput, bool* isSuccessful)
描述
确定是否可以将拍照输出添加到会话中。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PhotoOutput* cameraOutput | 要设置的拍照输出实例。 |
| bool* isSuccessful | 拍照输出是否可以添加到会话中的结果。返回true表示拍照输出可以添加到会话中，返回false表示不可以。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_CanAddVideoOutput()
Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* cameraOutput, bool* isSuccessful)
描述
确定是否可以将录像输出添加到会话中。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_VideoOutput* cameraOutput | 要添加的录像输出实例。 |
| bool* isSuccessful | 录像输出是否可以添加到会话中的结果。返回true表示录像输出可以添加到会话中，返回false表示不可以。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_CanPreconfig()
Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session, Camera_PreconfigType preconfigType, bool* canPreconfig)
描述
检查是否支持指定的预配置类型。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreconfigType preconfigType | 要检查的预配置类型。 |
| bool* canPreconfig | 是否支持预配置的结果。返回true表示支持预配置，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_CanPreconfigWithRatio()
Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio(Camera_CaptureSession* session, Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool* canPreconfig)
描述
检查是否支持带比例的预配置类型。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreconfigType preconfigType | 要检查的预配置类型。 |
| Camera_PreconfigRatio preconfigRatio | 要检查的预配置比例。 |
| bool* canPreconfig | 是否支持预配置的结果。返回true表示支持预配置，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_Preconfig()
Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session, Camera_PreconfigType preconfigType)
描述
设置预配置类型。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreconfigType preconfigType | 指定的预配置类型。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_PreconfigWithRatio()
Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session, Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)
描述
设置带有比例的预配置类型。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_PreconfigType preconfigType | 指定的预配置类型。 |
| Camera_PreconfigRatio preconfigRatio | 指定的预配置比例。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_GetExposureValue()
Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue)
描述
查询曝光值。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* exposureValue | 当前的曝光值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_GetFocalLength()
Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength)
描述
获取当前焦距值。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* focalLength | 当前焦距值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetFocusDistance()
Camera_ErrorCode OH_CaptureSession_GetFocusDistance(const Camera_CaptureSession* session, float* focusDistance)
描述
获取当前对焦距离。取值范围为[0.0, 1.0]。0.0表示镜头可对焦的最近距离；1.0表示最远距离。默认值为1.0。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| float* focusDistance | 输出参数，返回当前对焦距离。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或输入设备可能异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetFocusDistance()
Camera_ErrorCode OH_CaptureSession_SetFocusDistance(const Camera_CaptureSession* session, float focusDistance)
描述
设置对焦距离。取值范围为[0.0, 1.0]。0.0表示镜头可对焦的最近距离；1.0表示最远距离。默认值为1.0。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| float focusDistance | 待设置的对焦距离。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许，会话或输入设备可能异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsFocusDistanceSupported()
Camera_ErrorCode OH_CaptureSession_IsFocusDistanceSupported(const Camera_CaptureSession* session, bool* isSupported)
描述
查询是否支持对焦距离设置。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| bool* isSupported | 输出参数，返回是否支持对焦距离的结果。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetSmoothZoom()
Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session, float targetZoom, Camera_SmoothZoomMode smoothZoomMode)
描述
触发平滑变焦。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float targetZoom | 要设置的目标变焦比。 |
| Camera_SmoothZoomMode smoothZoomMode | 平滑变焦模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedColorSpaces()
Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace** colorSpace, uint32_t* size)
描述
获取支持的色彩空间列表。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_NativeBuffer_ColorSpace** colorSpace | 如果方法调用成功，将记录支持的OH_NativeBuffer_ColorSpace列表。 |
| uint32_t* size | 如果方法调用成功，将记录支持的OH_NativeBuffer_ColorSpace列表的大小。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_DeleteColorSpaces()
Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace* colorSpace)
描述
删除色彩空间列表。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_NativeBuffer_ColorSpace* colorSpace | 如果方法调用成功，将删除的OH_NativeBuffer_ColorSpace列表。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_GetActiveColorSpace()
Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace* colorSpace)
描述
获取当前色彩空间。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_NativeBuffer_ColorSpace* colorSpace | 当前的OH_NativeBuffer_ColorSpace。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetActiveColorSpace()
Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace colorSpace)
描述
设置当前色彩空间。
起始版本： 12
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_NativeBuffer_ColorSpace colorSpace | 要设置的目标OH_NativeBuffer_ColorSpace。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback()
Camera_ErrorCode OH_CaptureSession_RegisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session, OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)
描述
注册设备切换事件回调。
起始版本： 13
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange | 要注册的设备切换事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterAutoDeviceSwitchStatusCallback(Camera_CaptureSession* session, OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange)
描述
注销设备切换事件回调。
起始版本： 13
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| OH_CaptureSession_OnAutoDeviceSwitchStatusChange autoDeviceSwitchStatusChange | 要注销的设备切换事件回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_IsAutoDeviceSwitchSupported()
Camera_ErrorCode OH_CaptureSession_IsAutoDeviceSwitchSupported(Camera_CaptureSession* session, bool* isSupported)
描述
检查是否支持自动设备切换。
起始版本： 13
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool* isSupported | 是否支持自动设备切换的结果。返回true表示支持自动设备切换，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_EnableAutoDeviceSwitch()
Camera_ErrorCode OH_CaptureSession_EnableAutoDeviceSwitch(Camera_CaptureSession* session, bool enabled)
描述
是否启用相机设备的自动切换。
起始版本： 13
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool enabled | 是否启用自动切换的标志。返回true表示启用自动切换，返回false表示不启用。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_RegisterSystemPressureLevelChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange)
描述
注册系统压力状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange | 要注册的系统压力状态变化OH_CaptureSession_OnSystemPressureLevelChange回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterSystemPressureLevelChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange)
描述
注销系统压力状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnSystemPressureLevelChange systemPressureLevelChange | 要注销的系统压力状态变化OH_CaptureSession_OnSystemPressureLevelChange回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_SetQualityPrioritization()
Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization)
描述
设置录像质量优先级。
默认为高录像质量，设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。建议该接口在OH_CaptureSession_CommitConfig和OH_CaptureSession_Start之间调用。
起始版本： 14
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_QualityPrioritization qualityPrioritization | 要设置的录像质量优先级，默认为高录像质量。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsMacroSupported()
Camera_ErrorCode OH_CaptureSession_IsMacroSupported(Camera_CaptureSession* session, bool* isSupported)
描述
检查是否支持微距能力。
起始版本： 19
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool* isSupported | 是否支持微距能力的结果。返回true表示支持微距能力，返回false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK = 0：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_EnableMacro()
Camera_ErrorCode OH_CaptureSession_EnableMacro(Camera_CaptureSession* session, bool enabled)
描述
是否启用相机设备的微距能力。
起始版本： 19
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool enabled | 是否启用微距能力的标志。返回true表示启用微距能力，返回false表示不启用。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK = 0：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 CAMERA_OPERATION_NOT_ALLOWED：不允许操作。 |
OH_CaptureSession_SetWhiteBalance()
Camera_ErrorCode OH_CaptureSession_SetWhiteBalance(Camera_CaptureSession* session, int32_t colorTemperature)
描述
设置白平衡的色温。
设置前，建议通过OH_CaptureSession_GetWhiteBalanceRange获取支持配置的白平衡色温范围。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t colorTemperature | 色温值，单位为K。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：设置成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_GetColorTintRange()
Camera_ErrorCode OH_CaptureSession_GetColorTintRange(const Camera_CaptureSession* session, int32_t *minColorTint, int32_t *maxColorTint)
描述
获取支持配置的白平衡色调调节范围。
起始版本： 26
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t *minColorTint | 指向最小色调值的指针。 |
| int32_t *maxColorTint | 指向最大色调值的指针。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：当调用该方法时，捕获会话未配置。 |
OH_CaptureSession_GetColorTint()
Camera_ErrorCode OH_CaptureSession_GetColorTint(const Camera_CaptureSession* session, int32_t *colorTint)
描述
获取当前白平衡的色调调节值。
起始版本： 26
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t *colorTint | 指向色调值的指针。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：当调用该方法时，捕获会话未配置。 |
OH_CaptureSession_SetColorTint()
Camera_ErrorCode OH_CaptureSession_SetColorTint(const Camera_CaptureSession* session, int32_t colorTint)
描述
设置白平衡的色调调节值。设置前，建议通过OH_CaptureSession_GetColorTintRange获取支持配置的白平衡色调调节范围。
起始版本： 26
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t colorTint | 色调调节值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：当调用该方法时，捕获会话未配置。 |
OH_CaptureSession_GetWhiteBalance()
Camera_ErrorCode OH_CaptureSession_GetWhiteBalance(Camera_CaptureSession* session, int32_t *colorTemperature)
描述
获取当前白平衡色温值。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t *colorTemperature | 色温值，单位为K。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：函数调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_GetWhiteBalanceMode()
Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode* whiteBalanceMode)
描述
获取当前的白平衡模式。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_WhiteBalanceMode* whiteBalanceMode | 白平衡模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：函数调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_IsWhiteBalanceModeSupported()
Camera_ErrorCode OH_CaptureSession_IsWhiteBalanceModeSupported(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode, bool* isSupported)
描述
检查是否支持指定的白平衡模式。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_WhiteBalanceMode whiteBalanceMode | 指定的白平衡模式。 |
| bool* isSupported | 用于返回是否支持指定的白平衡模式，支持返回true，否则返回false。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：函数调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_SetWhiteBalanceMode()
Camera_ErrorCode OH_CaptureSession_SetWhiteBalanceMode(Camera_CaptureSession* session, Camera_WhiteBalanceMode whiteBalanceMode)
描述
设置白平衡模式。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_WhiteBalanceMode whiteBalanceMode | 白平衡模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：设置成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_GetWhiteBalanceRange()
Camera_ErrorCode OH_CaptureSession_GetWhiteBalanceRange(Camera_CaptureSession* session, int32_t *minColorTemperature, int32_t *maxColorTemperature)
描述
获取支持配置的白平衡色温范围。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| int32_t *minColorTemperature | 支持的最小色温值，单位为K。 |
| int32_t *maxColorTemperature | 支持的最大色温值，单位为K。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：函数调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：相机会话未配置。 |
OH_CaptureSession_IsControlCenterSupported()
Camera_ErrorCode OH_CaptureSession_IsControlCenterSupported(Camera_CaptureSession* session, bool* isSupported)
描述
检查是否支持相机控制器。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool* isSupported | 是否支持相机控制器的结果。true表示支持，false表示不支持。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK = 0：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedEffectTypes()
Camera_ErrorCode OH_CaptureSession_GetSupportedEffectTypes(Camera_CaptureSession* session, Camera_ControlCenterEffectType** types, uint32_t* size)
描述
获取相机控制器支持的效果类型。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_ControlCenterEffectType** types | 如果方法调用成功，将记录支持的Camera_ControlCenterEffectType列表。 |
| uint32_t* size | 如果方法调用成功，将记录支持的Camera_ControlCenterEffectType列表的大小。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_DeleteSupportedEffectTypes()
Camera_ErrorCode OH_CaptureSession_DeleteSupportedEffectTypes(Camera_CaptureSession* session, Camera_ControlCenterEffectType* types, uint32_t size)
描述
删除相机控制器效果类型列表。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| Camera_ControlCenterEffectType* types | 如果方法调用成功，要删除的Camera_ControlCenterEffectType列表。 |
| uint32_t size | 要删除的Camera_ControlCenterEffectType列表的大小。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_EnableControlCenter()
Camera_ErrorCode OH_CaptureSession_EnableControlCenter(Camera_CaptureSession* session, bool enabled)
描述
是否启用相机控制器。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| bool enabled | 是否启用相机控制器的标志。true表示启用，false表示禁用。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK = 0：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 CAMERA_SERVICE_FATAL_ERROR：相机服务异常。 |
OH_CaptureSession_RegisterControlCenterEffectStatusChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange)
描述
注册相机控制器效果激活状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange | 要注册的相机控制器效果激活状态变化OH_CaptureSession_OnControlCenterEffectStatusChange回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterControlCenterEffectStatusChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterControlCenterEffectStatusChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange)
描述
注销相机控制器效果激活状态变化回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 传递回调的Camera_CaptureSession实例。 |
| OH_CaptureSession_OnControlCenterEffectStatusChange controlCenterEffectStatusChange | 要注销的相机控制器效果激活状态变化OH_CaptureSession_OnControlCenterEffectStatusChange回调。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_OnMacroStatusChange()
typedef void (*OH_CaptureSession_OnMacroStatusChange)(Camera_CaptureSession* session, bool isMacroDetected)
描述
相机会话微距状态改变回调。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession实例的指针。 |
| bool isMacroDetected | 是否进入超级微距，true表示进入超级微距，false表示未进入超级微距。 |
OH_CaptureSession_RegisterMacroStatusChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterMacroStatusChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnMacroStatusChange macroStatusChange)
描述
注册相机会话微距状态改变回调函数。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession实例的指针。 |
| OH_CaptureSession_OnMacroStatusChange macroStatusChange | 微距状态改变回调函数。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_UnregisterMacroStatusChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterMacroStatusChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnMacroStatusChange macroStatusChange)
描述
取消注册相机会话微距状态改变回调函数。
起始版本： 20
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession实例的指针。 |
| OH_CaptureSession_OnMacroStatusChange macroStatusChange | 微距状态改变回调函数。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。 |
OH_CaptureSession_OnIsoChange()
typedef void (*OH_CaptureSession_OnIsoChange)(Camera_CaptureSession* session, int32_t isoValue)
描述
用于在相机会话中监听感光度（ISO）变化的回调函数。
起始版本： 22
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession的指针。 |
| int32_t isoValue | 回调中获取的感光度（ISO）的值。 |
OH_CaptureSession_RegisterIsoChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterIsoChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnIsoChange isoChange)
描述
注册监听感光度（ISO）改变的事件回调。
起始版本： 22
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession实例的指针。 |
| OH_CaptureSession_OnIsoChange isoChange | OH_CaptureSession_OnIsoChange类型的回调函数，用于监听ISO改变。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 |
OH_CaptureSession_UnregisterIsoChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterIsoChangeCallback(Camera_CaptureSession* session, OH_CaptureSession_OnIsoChange isoChange)
描述
取消注册监听感光度（ISO）改变的事件回调。
起始版本： 22
参数：
| 参数项 | 描述 |
|---|---|
| Camera_CaptureSession* session | 指向Camera_CaptureSession实例的指针。 |
| OH_CaptureSession_OnIsoChange isoChange | OH_CaptureSession_OnIsoChange类型的回调函数，用于监听ISO改变。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或者参数类型不正确。 |
OH_CaptureSession_GetRAWCaptureZoomRatioRange()
Camera_ErrorCode OH_CaptureSession_GetRAWCaptureZoomRatioRange(const Camera_CaptureSession* session, float* minZoom, float* maxZoom)
描述
查询物理镜头RAW图拍照支持的变焦范围。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| float* minZoom | 输出参数，返回变焦最小值。 |
| float* maxZoom | 输出参数，返回变焦最大值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许,会话或相机状态异常。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_IsOISModeSupported()
Camera_ErrorCode OH_CaptureSession_IsOISModeSupported(const Camera_CaptureSession* session, OH_Camera_OISMode oisMode, bool* isSupported)
描述
检查指定的光学防抖（OIS）模式是否支持。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_OISMode oisMode | 待检查的光学防抖模式。 |
| bool* isSupported | 输出参数，返回当前设备是否支持该模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetSupportedOISBiasRange()
Camera_ErrorCode OH_CaptureSession_GetSupportedOISBiasRange(const Camera_CaptureSession* session, OH_Camera_OISAxes oisAxis, float* minBias, float* maxBias, float* step)
描述
获取指定光学防抖轴支持的偏移范围。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_OISAxes oisAxis | 光学防抖轴。 |
| float* minBias | 输出参数，返回最小偏移值。 |
| float* maxBias | 输出参数，返回最大偏移值。 |
| float* step | 输出参数，返回偏移步长值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetCurrentOISMode()
Camera_ErrorCode OH_CaptureSession_GetCurrentOISMode(const Camera_CaptureSession* session, OH_Camera_OISMode* oisMode)
描述
获取当前光学防抖（OIS）模式。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_OISMode* oisMode | 输出参数，返回当前光学防抖模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_GetCurrentCustomOISBias()
Camera_ErrorCode OH_CaptureSession_GetCurrentCustomOISBias(const Camera_CaptureSession* session, float* pitchBias, float* yawBias)
描述
获取所有光学防抖轴当前的自定义偏移值。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| float* pitchBias | 输出参数，返回俯仰轴偏移值。 |
| float* yawBias | 输出参数，返回偏航轴偏移值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetOISMode()
Camera_ErrorCode OH_CaptureSession_SetOISMode(const Camera_CaptureSession* session, OH_Camera_OISMode oisMode)
描述
设置光学防抖（OIS）模式。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| OH_Camera_OISMode oisMode | 待设置的光学防抖模式。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_SetOISModeCustom()
Camera_ErrorCode OH_CaptureSession_SetOISModeCustom(const Camera_CaptureSession* session, float pitchBias, float yawBias)
描述
为对应轴设置自定义光学防抖偏移值。
起始版本： 24
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例指针。 |
| float pitchBias | 俯仰轴偏移值。 |
| float yawBias | 偏航轴偏移值。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_OnExposureStateChange()
typedef void (*OH_CaptureSession_OnExposureStateChange)(void* context, OH_Camera_ExposureState exposureState)
描述
定义曝光状态变更时的回调函数。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| (void* context | 指向自定义上下文的指针。 |
| OH_Camera_ExposureState exposureState | 当前曝光状态。 |
OH_CaptureSession_RegisterExposureStateChangeCallback()
Camera_ErrorCode OH_CaptureSession_RegisterExposureStateChangeCallback(const Camera_CaptureSession* session, void* context, OH_CaptureSession_OnExposureStateChange callback)
描述
注册曝光状态变化的回调。注册此回调后，当捕获会话中的曝光状态发生变化时，将调用该回调。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| void* context | 指向自定义上下文的指针。 |
| OH_CaptureSession_OnExposureStateChange callback | 表示曝光状态改变的回调函数。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或参数类型不正确。 |
OH_CaptureSession_UnregisterExposureStateChangeCallback()
Camera_ErrorCode OH_CaptureSession_UnregisterExposureStateChangeCallback(const Camera_CaptureSession* session, void* context, OH_CaptureSession_OnExposureStateChange callback)
描述
注销曝光状态变更时的回调函数。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | Camera_CaptureSession实例。 |
| void* context | 指向注册回调时指定的自定义上下文的指针。 |
| OH_CaptureSession_OnExposureStateChange callback | 表示曝光状态改变的回调函数。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数缺失或参数类型不正确。 |
OH_CaptureSession_GetZoomPointInfos()
Camera_ErrorCode OH_CaptureSession_GetZoomPointInfos(const Camera_CaptureSession* session, uint32_t* size, OH_Camera_ZoomPointInfo** zoomPointInfo)
描述
获取变焦点信息。
需要通过调用OH_CaptureSession_DeleteZoomPointInfos来释放变焦点信息的内存。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | 捕获会话对象的实例指针。 |
| uint32_t* size | 输出参数，返回查询到的变焦点信息数量。 |
| OH_Camera_ZoomPointInfo** zoomPointInfo | 输出参数，返回查询到的变焦点信息数组。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 CAMERA_OPERATION_NOT_ALLOWED：操作不允许。 CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。 |
OH_CaptureSession_DeleteZoomPointInfos()
Camera_ErrorCode OH_CaptureSession_DeleteZoomPointInfos(const Camera_CaptureSession* session, OH_Camera_ZoomPointInfo* zoomPointInfo)
描述
删除变焦点信息。
起始版本： 26.0.0
参数：
| 参数项 | 描述 |
|---|---|
| const Camera_CaptureSession* session | 捕获会话对象的实例指针。 |
| OH_Camera_ZoomPointInfo* zoomPointInfo | 待删除的变焦点信息数组，方法调用成功后该内存将被释放。 |
返回：
| 类型 | 说明 |
|---|---|
| Camera_ErrorCode | CAMERA_OK：方法调用成功。 CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。 |