OH_Camera

概述

为相机模块提供C接口的定义。

开发者可根据实际的开发需求，参考对应的开发指南及样例：

• 相机管理
• 设备输入
• 会话管理
• 预览
• 预览流二次处理
• 拍照
• 分段式拍照
• 录像
• 元数据
• 手电筒使用

系统能力： SystemCapability.Multimedia.Camera.Core

起始版本： 11

汇总

文件

名称	描述
camera.h	声明相机的基本概念。
camera_device.h	声明相机的基本概念。
camera_input.h	声明相机输入概念。
camera_manager.h	声明相机管理器的概念。
capture_session.h	声明捕获会话概念。
metadata_output.h	声明元数据输出概念。
photo_native.h	声明相机照片概念。
photo_output.h	声明拍照输出概念。
preview_output.h	声明预览输出概念。
video_output.h	声明录像输出概念。

结构体

名称	描述
struct Camera_Size	大小参数。
struct Camera_Profile	相机流的配置文件。
struct Camera_FrameRateRange	帧速率范围。
struct Camera_VideoProfile	录像配置文件。
struct Camera_OutputCapability	相机输出能力。
struct Camera_Device	相机设备对象。
struct Camera_StatusInfo	相机状态信息。
struct Camera_Point	点参数。
struct Camera_Location	拍照位置。
struct Camera_PhotoCaptureSetting	要设置的拍照捕获选项。
struct Camera_FrameShutterInfo	帧快门回调信息。
struct Camera_CaptureEndInfo	捕获结束信息。
struct Camera_Rect	矩形定义。
struct Camera_MetadataObject	元数据对象基础。
struct Camera_TorchStatusInfo	手电筒状态信息。
struct Camera_SmoothZoomInfo	平滑变焦参数信息。
struct Camera_CaptureStartInfo	拍照开始信息。
struct Camera_FrameShutterEndInfo	拍照曝光结束信息。
struct CameraInput_Callbacks	相机输入错误事件的回调。
struct CameraManager_Callbacks	相机设备状态的回调。
struct CaptureSession_Callbacks	捕获会话的回调。
struct MetadataOutput_Callbacks	元数据输出的回调。
struct PhotoOutput_Callbacks	拍照输出的回调。
struct PreviewOutput_Callbacks	用于预览输出的回调。
struct VideoOutput_Callbacks	用于录像输出的回调。

类型定义

名称	描述
typedef struct Camera_Manager Camera_Manager	相机管理器对象。
typedef enum Camera_ErrorCode Camera_ErrorCode	相机错误代码的枚举。
typedef enum Camera_Status Camera_Status	相机状态的枚举。
typedef enum Camera_SceneMode Camera_SceneMode	相机模式的枚举。
typedef enum Camera_Position Camera_Position	相机位置的枚举。
typedef enum Camera_Type Camera_Type	相机类型的枚举。
typedef enum Camera_Connection Camera_Connection	相机连接类型的枚举。
typedef enum Camera_Format Camera_Format	相机格式类型的枚举。
typedef enum Camera_FlashMode Camera_FlashMode	闪光模式的枚举。
typedef enum Camera_ExposureMode Camera_ExposureMode	曝光模式的枚举。
typedef enum Camera_FocusMode Camera_FocusMode	聚焦模式的枚举。
typedef enum Camera_FocusState Camera_FocusState	焦点状态的枚举。
typedef enum Camera_VideoStabilizationMode Camera_VideoStabilizationMode	录像防抖模式的枚举。
typedef enum Camera_ImageRotation Camera_ImageRotation	图像旋转角度的枚举。
typedef enum Camera_QualityLevel Camera_QualityLevel	图像质量等级的枚举。
typedef enum Camera_QualityPrioritization Camera_QualityPrioritization	录像质量优先级的枚举。
typedef enum Camera_MetadataObjectType Camera_MetadataObjectType	元数据对象类型的枚举。
typedef enum Camera_TorchMode Camera_TorchMode	手电筒模式的枚举。
typedef enum Camera_SmoothZoomMode Camera_SmoothZoomMode	平滑变焦模式的枚举。
typedef enum Camera_PreconfigType Camera_PreconfigType	预配置照片分辨率的枚举
typedef enum Camera_PreconfigRatio Camera_PreconfigRatio	预配置照片比例的枚举。
typedef enum Camera_HostDeviceType Camera_HostDeviceType	远程设备类型枚举。
typedef struct Camera_Size Camera_Size	大小参数。
typedef struct Camera_Profile Camera_Profile	相机流的配置文件。
typedef struct Camera_FrameRateRange Camera_FrameRateRange	帧速率范围。
typedef struct Camera_VideoProfile Camera_VideoProfile	录像配置文件。
typedef struct Camera_OutputCapability Camera_OutputCapability	相机输出能力。
typedef struct Camera_Device Camera_Device	相机设备对象。
typedef struct Camera_StatusInfo Camera_StatusInfo	相机状态信息。
typedef struct Camera_Point Camera_Point	点参数。
typedef struct Camera_Location Camera_Location	拍照位置。
typedef struct Camera_PhotoCaptureSetting Camera_PhotoCaptureSetting	要设置的拍照捕获选项。
typedef struct Camera_FrameShutterInfo Camera_FrameShutterInfo	帧快门回调信息。
typedef struct Camera_CaptureEndInfo Camera_CaptureEndInfo	捕获结束信息。
typedef struct Camera_Rect Camera_Rect	矩形定义。
typedef struct Camera_MetadataObject Camera_MetadataObject	元数据对象基础。
typedef struct Camera_TorchStatusInfo Camera_TorchStatusInfo	手电筒状态信息。
typedef struct Camera_SmoothZoomInfo Camera_SmoothZoomInfo	平滑变焦参数信息。
typedef struct Camera_CaptureStartInfo Camera_CaptureStartInfo	拍照开始信息。
typedef struct Camera_FrameShutterEndInfo Camera_FrameShutterEndInfo	拍照曝光结束信息。
typedef struct Camera_Input Camera_Input	相机输入对象。
typedef void(* OH_CameraInput_OnError) (const Camera_Input *cameraInput, Camera_ErrorCode errorCode)	在CameraInput_Callbacks中被调用的相机输入错误回调。
typedef struct CameraInput_Callbacks CameraInput_Callbacks	相机输入错误事件的回调。
typedef void(* OH_CameraManager_StatusCallback) (Camera_Manager *cameraManager, Camera_StatusInfo *status)	在CameraManager_Callbacks中被调用的相机管理器状态回调。
typedef void(* OH_CameraManager_TorchStatusCallback) (Camera_Manager *cameraManager, Camera_TorchStatusInfo *status)	手电筒状态变化回调。
typedef struct CameraManager_Callbacks CameraManager_Callbacks	相机设备状态的回调。
typedef struct Camera_CaptureSession Camera_CaptureSession	捕获会话对象
typedef void(* OH_CaptureSession_OnFocusStateChange) (Camera_CaptureSession *session, Camera_FocusState focusState)	在CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。
typedef void(* OH_CaptureSession_OnError) (Camera_CaptureSession *session, Camera_ErrorCode errorCode)	在CaptureSession_Callbacks中被调用的捕获会话错误回调。
typedef void(* OH_CaptureSession_OnSmoothZoomInfo) (Camera_CaptureSession *session, Camera_SmoothZoomInfo *smoothZoomInfo)	拍照会话平滑变焦信息回调，触发平滑变焦后该回调会返回。
typedef struct CaptureSession_Callbacks CaptureSession_Callbacks	捕获会话的回调。
typedef struct Camera_MetadataOutput Camera_MetadataOutput	元数据输出对象
typedef void(* OH_MetadataOutput_OnMetadataObjectAvailable) (Camera_MetadataOutput *metadataOutput, Camera_MetadataObject *metadataObject, uint32_t size)	在MetadataOutput_Callbacks中被调用的元数据输出元数据对象可用回调。
typedef void(* OH_MetadataOutput_OnError) (Camera_MetadataOutput *metadataOutput, Camera_ErrorCode errorCode)	在MetadataOutput_Callbacks中被调用的元数据输出错误回调。
typedef struct MetadataOutput_Callbacks MetadataOutput_Callbacks	元数据输出的回调。
typedef struct OH_PhotoNative OH_PhotoNative	相机照片对象。
typedef struct Camera_PhotoOutput Camera_PhotoOutput	拍照输出对象。
typedef void(* OH_PhotoOutput_OnFrameStart) (Camera_PhotoOutput *photoOutput)	在PhotoOutput_Callbacks中被调用的拍照输出帧启动回调。
typedef void(* OH_PhotoOutput_OnFrameShutter) (Camera_PhotoOutput *photoOutput, Camera_FrameShutterInfo *info)	在PhotoOutput_Callbacks中被调用的拍照输出帧快门回调。
typedef void(* OH_PhotoOutput_OnFrameEnd) (Camera_PhotoOutput *photoOutput, int32_t frameCount)	在PhotoOutput_Callbacks中被调用的拍照输出帧结束回调。
typedef void(* OH_PhotoOutput_OnError) (Camera_PhotoOutput *photoOutput, Camera_ErrorCode errorCode)	在PhotoOutput_Callbacks中被调用的拍照输出错误回调。
typedef void(* OH_PhotoOutput_CaptureEnd) (Camera_PhotoOutput *photoOutput, int32_t frameCount)	拍照结束回调。
typedef void(* OH_PhotoOutput_CaptureStartWithInfo) (Camera_PhotoOutput *photoOutput, Camera_CaptureStartInfo *Info)	拍照开始回调。
typedef void(* OH_PhotoOutput_OnFrameShutterEnd) (Camera_PhotoOutput *photoOutput, Camera_FrameShutterInfo *Info)	拍照曝光结束回调。
typedef void(* OH_PhotoOutput_CaptureReady) (Camera_PhotoOutput *photoOutput)	拍照准备就绪回调。收到回调后，可以继续进行下一次拍照。
typedef void(* OH_PhotoOutput_EstimatedCaptureDuration) (Camera_PhotoOutput *photoOutput, int64_t duration)	预计拍照时间回调。
typedef void(* OH_PhotoOutput_PhotoAvailable) (Camera_PhotoOutput *photoOutput, OH_PhotoNative *photo)	照片输出可用高分辨率图像回调。
typedef void(* OH_PhotoOutput_PhotoAssetAvailable) (Camera_PhotoOutput *photoOutput, OH_MediaAsset *photoAsset)	输出照片资源可用回调。
typedef struct PhotoOutput_Callbacks PhotoOutput_Callbacks	拍照输出的回调。
typedef struct Camera_PreviewOutput Camera_PreviewOutput	预览输出对象。
typedef void(* OH_PreviewOutput_OnFrameStart) (Camera_PreviewOutput *previewOutput)	在PreviewOutput_Callbacks中被调用的预览输出帧开始回调。
typedef void(* OH_PreviewOutput_OnFrameEnd) (Camera_PreviewOutput *previewOutput, int32_t frameCount)	在PreviewOutput_Callbacks中被调用的预览输出帧结束回调。
typedef void(* OH_PreviewOutput_OnError) (Camera_PreviewOutput *previewOutput, Camera_ErrorCode errorCode)	在PreviewOutput_Callbacks中被调用的预览输出帧错误回调。
typedef struct PreviewOutput_Callbacks PreviewOutput_Callbacks	用于预览输出的回调。
typedef struct Camera_VideoOutput Camera_VideoOutput	录像输出对象。
typedef void(* OH_VideoOutput_OnFrameStart) (Camera_VideoOutput *videoOutput)	在VideoOutput_Callbacks中被调用的录像输出帧开始回调。
typedef void(* OH_VideoOutput_OnFrameEnd) (Camera_VideoOutput *videoOutput, int32_t frameCount)	在VideoOutput_Callbacks中被调用的录像输出帧结束回调。
typedef void(* OH_VideoOutput_OnError) (Camera_VideoOutput *videoOutput, Camera_ErrorCode errorCode)	在VideoOutput_Callbacks中被调用的录像输出错误回调。
typedef struct VideoOutput_Callbacks VideoOutput_Callbacks	用于录像输出的回调。
typedef struct Camera_QualityPrioritization Camera_QualityPrioritization	录像质量优先级。

枚举

名称	描述
Camera_ErrorCode { CAMERA_OK = 0, CAMERA_INVALID_ARGUMENT = 7400101, CAMERA_OPERATION_NOT_ALLOWED = 7400102, CAMERA_SESSION_NOT_CONFIG = 7400103, CAMERA_SESSION_NOT_RUNNING = 7400104, CAMERA_SESSION_CONFIG_LOCKED = 7400105, CAMERA_DEVICE_SETTING_LOCKED = 7400106, CAMERA_CONFLICT_CAMERA = 7400107, CAMERA_DEVICE_DISABLED = 7400108, CAMERA_DEVICE_PREEMPTED = 7400109, CAMERA_UNRESOLVED_CONFLICTS_WITH_CURRENT_CONFIGURATIONS = 7400110, CAMERA_SERVICE_FATAL_ERROR = 7400201}	相机错误代码的枚举。
Camera_Status { CAMERA_STATUS_APPEAR = 0, CAMERA_STATUS_DISAPPEAR = 1, CAMERA_STATUS_AVAILABLE = 2, CAMERA_STATUS_UNAVAILABLE = 3 }	相机状态的枚举。
Camera_SceneMode { NORMAL_PHOTO = 1, NORMAL_VIDEO = 2, SECURE_PHOTO = 12 }	相机模式的枚举。
Camera_Position { CAMERA_POSITION_UNSPECIFIED = 0, CAMERA_POSITION_BACK = 1, CAMERA_POSITION_FRONT = 2 }	相机位置的枚举。
Camera_Type { CAMERA_TYPE_DEFAULT = 0, CAMERA_TYPE_WIDE_ANGLE = 1, CAMERA_TYPE_ULTRA_WIDE = 2, CAMERA_TYPE_TELEPHOTO = 3, CAMERA_TYPE_TRUE_DEPTH = 4 }	相机类型的枚举。
Camera_Connection { CAMERA_CONNECTION_BUILT_IN = 0, CAMERA_CONNECTION_USB_PLUGIN = 1, CAMERA_CONNECTION_REMOTE = 2 }	相机连接类型的枚举。
Camera_Format { CAMERA_FORMAT_RGBA_8888 = 3, CAMERA_FORMAT_YUV_420_SP = 1003, CAMERA_FORMAT_JPEG = 2000, CAMERA_FORMAT_YCBCR_P010 = 2001, CAMERA_FORMAT_YCRCB_P010 = 2002 }	相机格式类型的枚举。
Camera_FlashMode { FLASH_MODE_CLOSE = 0, FLASH_MODE_OPEN = 1, FLASH_MODE_AUTO = 2, FLASH_MODE_ALWAYS_OPEN = 3 }	闪光模式的枚举。
Camera_ExposureMode { EXPOSURE_MODE_LOCKED = 0, EXPOSURE_MODE_AUTO = 1, EXPOSURE_MODE_CONTINUOUS_AUTO = 2 }	曝光模式的枚举。
Camera_FocusMode { FOCUS_MODE_MANUAL = 0, FOCUS_MODE_CONTINUOUS_AUTO = 1, FOCUS_MODE_AUTO = 2, FOCUS_MODE_LOCKED = 3 }	聚焦模式的枚举。
Camera_FocusState { FOCUS_STATE_SCAN = 0, FOCUS_STATE_FOCUSED = 1, FOCUS_STATE_UNFOCUSED = 2 }	焦点状态的枚举。
Camera_VideoStabilizationMode { STABILIZATION_MODE_OFF = 0, STABILIZATION_MODE_LOW = 1, STABILIZATION_MODE_MIDDLE = 2, STABILIZATION_MODE_HIGH = 3, STABILIZATION_MODE_AUTO = 4 }	录像防抖模式的枚举。
Camera_ImageRotation { IAMGE_ROTATION_0 = 0, IAMGE_ROTATION_90 = 90, IAMGE_ROTATION_180 = 180, IAMGE_ROTATION_270 = 270 }	图像旋转角度的枚举。
Camera_QualityLevel { QUALITY_LEVEL_HIGH = 0, QUALITY_LEVEL_MEDIUM = 1, QUALITY_LEVEL_LOW = 2 }	图像质量等级的枚举。
Camera_HostDeviceType { HOST_DEVICE_TYPE_UNKNOWN_TYPE = 0, HOST_DEVICE_TYPE_PHONE = 0x0E, HOST_DEVICE_TYPE_TABLET = 0x11 }	远程设备类型枚举。
Camera_QualityPrioritization { HIGH_QUALITY = 0, POWER_BALANCE = 1}	录像质量优先级的枚举。
Camera_MetadataObjectType { FACE_DETECTION = 0 }	元数据对象类型的枚举。
Camera_TorchMode { OFF = 0, ON = 1, AUTO = 2 }	手电筒模式的枚举。
Camera_SmoothZoomMode { NORMAL = 0 }	平滑变焦模式的枚举。
Camera_PreconfigType { PRECONFIG_720P = 0, PRECONFIG_1080P = 1, PRECONFIG_4K = 2, PRECONFIG_HIGH_QUALITY = 3 }	预配置照片分辨率的枚举
Camera_PreconfigRatio { PRECONFIG_RATIO_1_1 = 0, PRECONFIG_RATIO_4_3 = 1, PRECONFIG_RATIO_16_9 = 2 }	预配置照片比例的枚举。

函数

名称	描述
Camera_ErrorCode OH_Camera_GetCameraManager (Camera_Manager **cameraManager)	创建CameraManager实例。
Camera_ErrorCode OH_Camera_DeleteCameraManager (Camera_Manager *cameraManager)	删除CameraManager实例。
Camera_ErrorCode OH_CameraDevice_GetCameraOrientation (Camera_Device *camera, uint32_t *orientation)	获取相机设备的传感器方向属性。
Camera_ErrorCode OH_CameraInput_RegisterCallback (Camera_Input *cameraInput, CameraInput_Callbacks *callback)	注册相机输入更改事件回调。
Camera_ErrorCode OH_CameraInput_UnregisterCallback (Camera_Input *cameraInput, CameraInput_Callbacks *callback)	注销相机输入更改事件回调。
Camera_ErrorCode OH_CameraInput_Open (Camera_Input *cameraInput)	打开相机。
Camera_ErrorCode OH_CameraInput_OpenSecureCamera (Camera_Input *cameraInput, uint64_t *secureSeqId)	打开安全相机。
Camera_ErrorCode OH_CameraInput_Close (Camera_Input *cameraInput)	关闭相机。
Camera_ErrorCode OH_CameraInput_Release (Camera_Input *cameraInput)	和OH_CameraInput_Close只需要调用其中一个，调用之后无须再调用OH_CameraInput_Close。
Camera_ErrorCode OH_CameraManager_RegisterCallback (Camera_Manager *cameraManager, CameraManager_Callbacks *callback)	注册相机状态更改事件回调。
Camera_ErrorCode OH_CameraManager_UnregisterCallback (Camera_Manager *cameraManager, CameraManager_Callbacks *callback)	注销相机状态更改事件回调。
Camera_ErrorCode OH_CameraManager_RegisterTorchStatusCallback (Camera_Manager *cameraManager, OH_CameraManager_TorchStatusCallback torchStatusCallback)	注册手电筒状态变更事件回调。
Camera_ErrorCode OH_CameraManager_UnregisterTorchStatusCallback (Camera_Manager *cameraManager, OH_CameraManager_TorchStatusCallback torchStatusCallback)	注销手电筒状态变更事件回调。
Camera_ErrorCode OH_CameraManager_GetSupportedCameras (Camera_Manager *cameraManager, Camera_Device **cameras, uint32_t *size)	获取支持相机的描述。
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameras (Camera_Manager *cameraManager, Camera_Device *cameras, uint32_t size)	删除支持的相机。
Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapability (Camera_Manager *cameraManager, const Camera_Device *camera, Camera_OutputCapability **cameraOutputCapability)	查询指定相机在指定模式下支持的输出能力。
Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapabilityWithSceneMode (Camera_Manager *cameraManager, const Camera_Device *camera, Camera_SceneMode sceneMode, Camera_OutputCapability **cameraOutputCapability)	查询指定相机在指定模式下支持的输出能力。
Camera_ErrorCode OH_CameraManager_DeleteSupportedCameraOutputCapability (Camera_Manager *cameraManager, Camera_OutputCapability *cameraOutputCapability)	删除支持的输出功能。
Camera_ErrorCode OH_CameraManager_IsCameraMuted (Camera_Manager *cameraManager, bool *isCameraMuted)	确定相机是否静音。
Camera_ErrorCode OH_CameraManager_CreateCaptureSession (Camera_Manager *cameraManager, Camera_CaptureSession **captureSession)	创建捕获会话实例。
Camera_ErrorCode OH_CameraManager_CreateCameraInput (Camera_Manager *cameraManager, const Camera_Device *camera, Camera_Input **cameraInput)	创建相机输入实例。
Camera_ErrorCode OH_CameraManager_CreateCameraInput_WithPositionAndType (Camera_Manager *cameraManager, Camera_Position position, Camera_Type type, Camera_Input **cameraInput)	创建具有位置和类型的相机输入实例
Camera_ErrorCode OH_CameraManager_CreatePreviewOutput (Camera_Manager *cameraManager, const Camera_Profile *profile, const char *surfaceId, Camera_PreviewOutput **previewOutput)	创建预览输出实例。
Camera_ErrorCode OH_CameraManager_CreatePreviewOutputUsedInPreconfig (Camera_Manager *cameraManager, const char *surfaceId, Camera_PreviewOutput **previewOutput)	创建在预配置流中使用的预览输出实例。
Camera_ErrorCode OH_CameraManager_CreatePhotoOutput (Camera_Manager *cameraManager, const Camera_Profile *profile, const char *surfaceId, Camera_PhotoOutput **photoOutput)	创建一个拍照输出实例。
Camera_ErrorCode OH_CameraManager_CreatePhotoOutputUsedInPreconfig (Camera_Manager *cameraManager, const char *surfaceId, Camera_PhotoOutput **photoOutput)	创建在预配置流中使用的照片输出实例。
Camera_ErrorCode OH_CameraManager_CreatePhotoOutputWithoutSurface (Camera_Manager *cameraManager, const Camera_Profile *profile, Camera_PhotoOutput **photoOutput)	创建照片输出实例，调用此函数不需要surfaceId。
Camera_ErrorCode OH_CameraManager_CreateVideoOutput (Camera_Manager *cameraManager, const Camera_VideoProfile *profile, const char *surfaceId, Camera_VideoOutput **videoOutput)	创建一个录像输出实例。
Camera_ErrorCode OH_CameraManager_CreateVideoOutputUsedInPreconfig (Camera_Manager *cameraManager, const char *surfaceId, Camera_VideoOutput **videoOutput)	创建在预配置流中使用的视频输出实例。
Camera_ErrorCode OH_CameraManager_CreateMetadataOutput (Camera_Manager *cameraManager, const Camera_MetadataObjectType *profile, Camera_MetadataOutput **metadataOutput)	创建元数据输出实例。
Camera_ErrorCode OH_CameraManager_GetSupportedSceneModes (Camera_Device *camera, Camera_SceneMode **sceneModes, uint32_t *size)	获取特定相机支持的场景模式。
Camera_ErrorCode OH_CameraManager_DeleteSceneModes (Camera_Manager *cameraManager, Camera_SceneMode *sceneModes)	删除场景模式。
Camera_ErrorCode OH_CameraManager_IsTorchSupported (Camera_Manager *cameraManager, bool *isTorchSupported)	检查设备是否支持手电筒。
Camera_ErrorCode OH_CameraManager_IsTorchSupportedByTorchMode (Camera_Manager *cameraManager, Camera_TorchMode torchMode, bool *isTorchSupported)	检查设备是否支持指定的手电筒模式。
Camera_ErrorCode OH_CameraManager_SetTorchMode (Camera_Manager *cameraManager, Camera_TorchMode torchMode)	设置相机手电筒模式。
Camera_ErrorCode OH_CaptureSession_RegisterCallback (Camera_CaptureSession *session, CaptureSession_Callbacks *callback)	注册捕获会话事件回调。
Camera_ErrorCode OH_CaptureSession_UnregisterCallback (Camera_CaptureSession *session, CaptureSession_Callbacks *callback)	注销捕获会话事件回调。
Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback (Camera_CaptureSession *session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)	注册平滑变焦信息事件回调。
Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback (Camera_CaptureSession *session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)	注销平滑变焦信息事件回调。
Camera_ErrorCode OH_CaptureSession_SetSessionMode (Camera_CaptureSession *session, Camera_SceneMode sceneMode)	设置会话模式。
Camera_ErrorCode OH_CaptureSession_AddSecureOutput (Camera_CaptureSession *session, Camera_PreviewOutput *previewOutput)	把其中一条PreviewOutput标记成安全输出。
Camera_ErrorCode OH_CaptureSession_BeginConfig (Camera_CaptureSession *session)	开始捕获会话配置。
Camera_ErrorCode OH_CaptureSession_CommitConfig (Camera_CaptureSession *session)	提交捕获会话配置。
Camera_ErrorCode OH_CaptureSession_AddInput (Camera_CaptureSession *session, Camera_Input *cameraInput)	添加相机输入。
Camera_ErrorCode OH_CaptureSession_RemoveInput (Camera_CaptureSession *session, Camera_Input *cameraInput)	删除相机输入。
Camera_ErrorCode OH_CaptureSession_AddPreviewOutput (Camera_CaptureSession *session, Camera_PreviewOutput *previewOutput)	添加预览输出。
Camera_ErrorCode OH_CaptureSession_RemovePreviewOutput (Camera_CaptureSession *session, Camera_PreviewOutput *previewOutput)	删除预览输出。
Camera_ErrorCode OH_CaptureSession_AddPhotoOutput (Camera_CaptureSession *session, Camera_PhotoOutput *photoOutput)	添加拍照输出。
Camera_ErrorCode OH_CaptureSession_RemovePhotoOutput (Camera_CaptureSession *session, Camera_PhotoOutput *photoOutput)	删除拍照输出。
Camera_ErrorCode OH_CaptureSession_AddVideoOutput (Camera_CaptureSession *session, Camera_VideoOutput *videoOutput)	添加录像输出。
Camera_ErrorCode OH_CaptureSession_RemoveVideoOutput (Camera_CaptureSession *session, Camera_VideoOutput *videoOutput)	删除录像输出。
Camera_ErrorCode OH_CaptureSession_AddMetadataOutput (Camera_CaptureSession *session, Camera_MetadataOutput *metadataOutput)	添加元数据输出。
Camera_ErrorCode OH_CaptureSession_RemoveMetadataOutput (Camera_CaptureSession *session, Camera_MetadataOutput *metadataOutput)	删除元数据输出。
Camera_ErrorCode OH_CaptureSession_Start (Camera_CaptureSession *session)	启动捕获会话。
Camera_ErrorCode OH_CaptureSession_Stop (Camera_CaptureSession *session)	停止捕获会话。
Camera_ErrorCode OH_CaptureSession_Release (Camera_CaptureSession *session)	释放捕获会话。
Camera_ErrorCode OH_CaptureSession_HasFlash (Camera_CaptureSession *session, bool *hasFlash)	检查设备是否有闪光灯。
Camera_ErrorCode OH_CaptureSession_IsFlashModeSupported (Camera_CaptureSession *session, Camera_FlashMode flashMode, bool *isSupported)	检查是否支持指定的闪光灯模式。
Camera_ErrorCode OH_CaptureSession_GetFlashMode (Camera_CaptureSession *session, Camera_FlashMode *flashMode)	获取当前闪光灯模式。
Camera_ErrorCode OH_CaptureSession_SetFlashMode (Camera_CaptureSession *session, Camera_FlashMode flashMode)	设置闪光灯模式。
Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported (Camera_CaptureSession *session, Camera_ExposureMode exposureMode, bool *isSupported)	检查是否支持指定的曝光模式。
Camera_ErrorCode OH_CaptureSession_GetExposureMode (Camera_CaptureSession *session, Camera_ExposureMode *exposureMode)	获取当前曝光模式。
Camera_ErrorCode OH_CaptureSession_SetExposureMode (Camera_CaptureSession *session, Camera_ExposureMode exposureMode)	设置曝光模式。
Camera_ErrorCode OH_CaptureSession_GetMeteringPoint (Camera_CaptureSession *session, Camera_Point *point)	获取当前测量点。
Camera_ErrorCode OH_CaptureSession_SetMeteringPoint (Camera_CaptureSession *session, Camera_Point point)	设置计量区域的中心点。
Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange (Camera_CaptureSession *session, float *minExposureBias, float *maxExposureBias, float *step)	查询曝光补偿范围。
Camera_ErrorCode OH_CaptureSession_SetExposureBias (Camera_CaptureSession *session, float exposureBias)	设置曝光补偿。
Camera_ErrorCode OH_CaptureSession_GetExposureBias (Camera_CaptureSession *session, float *exposureBias)	获取当前曝光补偿。
Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported (Camera_CaptureSession *session, Camera_FocusMode focusMode, bool *isSupported)	检查是否支持指定的聚焦模式。
Camera_ErrorCode OH_CaptureSession_GetFocusMode (Camera_CaptureSession *session, Camera_FocusMode *focusMode)	获取当前聚焦模式。
Camera_ErrorCode OH_CaptureSession_SetFocusMode (Camera_CaptureSession *session, Camera_FocusMode focusMode)	设置聚焦模式。
Camera_ErrorCode OH_CaptureSession_GetFocusPoint (Camera_CaptureSession *session, Camera_Point *focusPoint)	获取当前焦点。
Camera_ErrorCode OH_CaptureSession_SetFocusPoint (Camera_CaptureSession *session, Camera_Point focusPoint)	设置焦点。
Camera_ErrorCode OH_CaptureSession_GetZoomRatioRange (Camera_CaptureSession *session, float *minZoom, float *maxZoom)	获取所有支持的缩放比例范围。
Camera_ErrorCode OH_CaptureSession_GetZoomRatio (Camera_CaptureSession *session, float *zoom)	获取当前缩放比例。
Camera_ErrorCode OH_CaptureSession_SetZoomRatio (Camera_CaptureSession *session, float zoom)	设置缩放比例。
Camera_ErrorCode OH_CaptureSession_IsVideoStabilizationModeSupported (Camera_CaptureSession *session, Camera_VideoStabilizationMode mode, bool *isSupported)	检查是否支持指定的录像防抖模式。
Camera_ErrorCode OH_CaptureSession_GetVideoStabilizationMode (Camera_CaptureSession *session, Camera_VideoStabilizationMode *mode)	获取当前录像防抖模式。
Camera_ErrorCode OH_CaptureSession_SetVideoStabilizationMode (Camera_CaptureSession *session, Camera_VideoStabilizationMode mode)	设置录像防抖模式。
Camera_ErrorCode OH_CaptureSession_CanAddInput (Camera_CaptureSession *session, Camera_Input *cameraInput, bool *isSuccessful)	确定是否可以将相机输入添加到会话中。
Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput (Camera_CaptureSession *session, Camera_PreviewOutput *cameraOutput, bool *isSuccessful)	确定是否可以将相机预览输出添加到会话中。
Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput (Camera_CaptureSession *session, Camera_PhotoOutput *cameraOutput, bool *isSuccessful)	确定是否可以将相机照片输出添加到会话中。
Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput (Camera_CaptureSession *session, Camera_VideoOutput *cameraOutput, bool *isSuccessful)	确定是否可以将相机视频输出添加到会话中。
Camera_ErrorCode OH_CaptureSession_CanPreconfig (Camera_CaptureSession *session, Camera_PreconfigType preconfigType, bool *canPreconfig)	检查是否支持指定的预配置类型。
Camera_ErrorCode OH_CaptureSession_CanPreconfigWithRatio (Camera_CaptureSession *session, Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio, bool *canPreconfig)	检查是否支持带比例的预配置类型。
Camera_ErrorCode OH_CaptureSession_Preconfig (Camera_CaptureSession *session, Camera_PreconfigType preconfigType)	设置预配置类型。
Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio (Camera_CaptureSession *session, Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)	设置带有比例的预配置类型。
Camera_ErrorCode OH_CaptureSession_GetExposureValue (Camera_CaptureSession *session, float *exposureValue)	查询曝光值。
Camera_ErrorCode OH_CaptureSession_GetFocalLength (Camera_CaptureSession *session, float *focalLength)	获取当前焦距值。
Camera_ErrorCode OH_CaptureSession_SetSmoothZoom (Camera_CaptureSession *session, float targetZoom, Camera_SmoothZoomMode smoothZoomMode)	触发平滑变焦。
Camera_ErrorCode OH_CaptureSession_GetSupportedColorSpaces (Camera_CaptureSession *session, OH_NativeBuffer_ColorSpace **colorSpace, uint32_t *size)	获取支持的色彩空间列表。
Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces (Camera_CaptureSession *session, OH_NativeBuffer_ColorSpace *colorSpace)	删除色彩空间列表。
Camera_ErrorCode OH_CaptureSession_GetActiveColorSpace (Camera_CaptureSession *session, OH_NativeBuffer_ColorSpace *colorSpace)	获取当前色彩空间。
Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace (Camera_CaptureSession *session, OH_NativeBuffer_ColorSpace colorSpace)	设置当前色彩空间。
Camera_ErrorCode OH_MetadataOutput_RegisterCallback (Camera_MetadataOutput *metadataOutput, MetadataOutput_Callbacks *callback)	注册元数据输出更改事件回调。
Camera_ErrorCode OH_MetadataOutput_UnregisterCallback (Camera_MetadataOutput *metadataOutput, MetadataOutput_Callbacks *callback)	注销元数据输出更改事件回调。
Camera_ErrorCode OH_MetadataOutput_Start (Camera_MetadataOutput *metadataOutput)	启动元数据输出。
Camera_ErrorCode OH_MetadataOutput_Stop (Camera_MetadataOutput *metadataOutput)	停止元数据输出。
Camera_ErrorCode OH_MetadataOutput_Release (Camera_MetadataOutput *metadataOutput)	释放元数据输出。
Camera_ErrorCode OH_PhotoNative_GetMainImage (OH_PhotoNative *photo, OH_ImageNative **mainImage)	获取全质量图。
Camera_ErrorCode OH_PhotoNative_Release (OH_PhotoNative *photo)	释放全质量图实例。
Camera_ErrorCode OH_PhotoOutput_RegisterCallback (Camera_PhotoOutput *photoOutput, PhotoOutput_Callbacks *callback)	注册拍照输出更改事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterCallback (Camera_PhotoOutput *photoOutput, PhotoOutput_Callbacks *callback)	注销拍照输出更改事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterCaptureStartWithInfoCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureStartWithInfo callback)	注册拍照开始事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureStartWithInfoCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureStartWithInfo callback)	注销拍照开始事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterCaptureEndCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureEnd callback)	注册拍照结束事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureEndCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureEnd callback)	注销拍照结束事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterFrameShutterEndCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_OnFrameShutterEnd callback)	注册拍照曝光结束事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterFrameShutterEndCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_OnFrameShutterEnd callback)	注销拍照曝光结束事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterCaptureReadyCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureReady callback)	注册拍照就绪事件回调。收到回调后，可以继续进行下一次拍照。
Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureReadyCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_CaptureReady callback)	注销拍照就绪事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterEstimatedCaptureDurationCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_EstimatedCaptureDuration callback)	注册预计拍照时间事件回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterEstimatedCaptureDurationCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_EstimatedCaptureDuration callback)	注销预计拍照时间事件回调。
Camera_ErrorCode OH_PhotoOutput_RegisterPhotoAvailableCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_PhotoAvailable callback)	注册输出照片可用回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterPhotoAvailableCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_PhotoAvailable callback)	注销输出照片可用回调。
Camera_ErrorCode OH_PhotoOutput_RegisterPhotoAssetAvailableCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_PhotoAssetAvailable callback)	注册输出照片资源可用回调。
Camera_ErrorCode OH_PhotoOutput_UnregisterPhotoAssetAvailableCallback (Camera_PhotoOutput *photoOutput, OH_PhotoOutput_PhotoAssetAvailable callback)	注销输出照片资源可用回调。
Camera_ErrorCode OH_PhotoOutput_Capture (Camera_PhotoOutput *photoOutput)	拍摄照片。
Camera_ErrorCode OH_PhotoOutput_Capture_WithCaptureSetting (Camera_PhotoOutput *photoOutput, Camera_PhotoCaptureSetting setting)	使用捕获设置捕获拍照。
Camera_ErrorCode OH_PhotoOutput_Release (Camera_PhotoOutput *photoOutput)	释放拍照输出。
Camera_ErrorCode OH_PhotoOutput_IsMirrorSupported (Camera_PhotoOutput *photoOutput, bool *isSupported)	检查是否支持镜像拍照。
Camera_ErrorCode OH_PhotoOutput_EnableMirror (Camera_PhotoOutput *photoOutput, bool enabled)	是否启用镜像拍照。
Camera_ErrorCode OH_PhotoOutput_GetActiveProfile (Camera_PhotoOutput *photoOutput, Camera_Profile **profile)	获取当前照片输出配置文件。
Camera_ErrorCode OH_PhotoOutput_DeleteProfile (Camera_Profile *profile)	删除照片配置文件实例。
Camera_ErrorCode OH_PhotoOutput_IsMovingPhotoSupported (Camera_PhotoOutput *photoOutput, bool *isSupported)	检查是否支持动态照片。
Camera_ErrorCode OH_PhotoOutput_EnableMovingPhoto (Camera_PhotoOutput *photoOutput, bool enabled)	是否启用动态照片。
Camera_ErrorCode OH_PreviewOutput_RegisterCallback (Camera_PreviewOutput *previewOutput, PreviewOutput_Callbacks *callback)	注册预览输出更改事件回调。
Camera_ErrorCode OH_PreviewOutput_UnregisterCallback (Camera_PreviewOutput *previewOutput, PreviewOutput_Callbacks *callback)	注销预览输出更改事件回调。
Camera_ErrorCode OH_PreviewOutput_Start (Camera_PreviewOutput *previewOutput)	开始预览输出。
Camera_ErrorCode OH_PreviewOutput_Stop (Camera_PreviewOutput *previewOutput)	停止预览输出。
Camera_ErrorCode OH_PreviewOutput_Release (Camera_PreviewOutput *previewOutput)	释放预览输出。
Camera_ErrorCode OH_PreviewOutput_GetActiveProfile (Camera_PreviewOutput *previewOutput, Camera_Profile **profile)	获取当前预览输出配置文件。
Camera_ErrorCode OH_PreviewOutput_DeleteProfile (Camera_Profile *profile)	删除预览配置文件实例。
Camera_ErrorCode OH_PreviewOutput_GetSupportedFrameRates (Camera_PreviewOutput *previewOutput, Camera_FrameRateRange **frameRateRange, uint32_t *size)	获取支持的预览输出帧率列表。
Camera_ErrorCode OH_PreviewOutput_DeleteFrameRates (Camera_PreviewOutput *previewOutput, Camera_FrameRateRange *frameRateRange)	删除帧率列表。
Camera_ErrorCode OH_PreviewOutput_SetFrameRate (Camera_PreviewOutput *previewOutput, int32_t minFps, int32_t maxFps)	设置预览输出帧率。
Camera_ErrorCode OH_PreviewOutput_GetActiveFrameRate (Camera_PreviewOutput *previewOutput, Camera_FrameRateRange *frameRateRange)	获取当前预览输出帧率。
Camera_ErrorCode OH_VideoOutput_RegisterCallback (Camera_VideoOutput *videoOutput, VideoOutput_Callbacks *callback)	注册录像输出更改事件回调。
Camera_ErrorCode OH_VideoOutput_UnregisterCallback (Camera_VideoOutput *videoOutput, VideoOutput_Callbacks *callback)	注销录像输出更改事件回调。
Camera_ErrorCode OH_VideoOutput_Start (Camera_VideoOutput *videoOutput)	开始录像输出。
Camera_ErrorCode OH_VideoOutput_Stop (Camera_VideoOutput *videoOutput)	停止录像输出。
Camera_ErrorCode OH_VideoOutput_Release (Camera_VideoOutput *videoOutput)	释放录像输出。
Camera_ErrorCode OH_VideoOutput_GetActiveProfile (Camera_VideoOutput *videoOutput, Camera_VideoProfile **profile)	获取当前视频输出配置文件。
Camera_ErrorCode OH_VideoOutput_DeleteProfile (Camera_VideoProfile *profile)	删除视频配置文件实例。
Camera_ErrorCode OH_VideoOutput_GetSupportedFrameRates (Camera_VideoOutput *videoOutput, Camera_FrameRateRange **frameRateRange, uint32_t *size)	获取支持的视频输出帧率列表。
Camera_ErrorCode OH_VideoOutput_DeleteFrameRates (Camera_VideoOutput *videoOutput, Camera_FrameRateRange *frameRateRange)	删除帧率列表。
Camera_ErrorCode OH_VideoOutput_SetFrameRate (Camera_VideoOutput *videoOutput, int32_t minFps, int32_t maxFps)	设置视频输出帧率。
Camera_ErrorCode OH_VideoOutput_GetActiveFrameRate (Camera_VideoOutput *videoOutput, Camera_FrameRateRange *frameRateRange)	获取当前视频输出帧率。
Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization (Camera_CaptureSession *session, Camera_QualityPrioritization qualityPrioritization)	设置当前录像质量优先级。
Camera_ErrorCode OH_CameraDevice_GetHostDeviceName (Camera_Device *camera, char **hostDeviceName)	获取远程设备名称。
Camera_ErrorCode OH_CameraDevice_GetHostDeviceType (Camera_Device *camera, Camera_HostDeviceType *hostDeviceType)	获取远程设备类型。
Camera_ErrorCode OH_VideoOutput_IsMirrorSupported (Camera_VideoOutput *videoOutput, bool *isSupported)	判断当前视频输出是否支持镜像。
Camera_ErrorCode OH_VideoOutput_EnableMirror (Camera_VideoOutput *videoOutput, bool mirrorMode)	打开/关闭当前视频输出镜像功能。
Camera_ErrorCode OH_VideoOutput_GetVideoRotation (Camera_VideoOutput *videoOutput, int deviceDegree, Camera_ImageRotation *imageRotation)	获取当前视频输出应当设置的旋转角度。

类型定义说明

Camera_CaptureEndInfo

typedef struct Camera_CaptureEndInfo Camera_CaptureEndInfo

描述

捕获结束信息。

起始版本： 11

Camera_CaptureSession

typedef struct Camera_CaptureSession Camera_CaptureSession

描述

捕获会话对象。

可以使用OH_CameraManager_CreateCaptureSession方法创建指针。

起始版本： 11

Camera_CaptureStartInfo

typedef struct Camera_CaptureStartInfo Camera_CaptureStartInfo

描述

拍照开始信息。

起始版本： 12

Camera_Connection

typedef enum Camera_Connection Camera_Connection

描述

相机连接类型的枚举。

起始版本： 11

Camera_Device

typedef struct Camera_Device Camera_Device

描述

相机设备对象。

起始版本： 11

Camera_ErrorCode

typedef enum Camera_ErrorCode Camera_ErrorCode

描述

相机错误代码的枚举。

起始版本： 11

Camera_ExposureMode

typedef enum Camera_ExposureMode Camera_ExposureMode

描述

曝光模式的枚举。

起始版本： 11

Camera_FlashMode

typedef enum Camera_FlashMode Camera_FlashMode

描述

闪光模式的枚举。

起始版本： 11

Camera_FocusMode

typedef enum Camera_FocusMode Camera_FocusMode

描述

聚焦模式的枚举。

起始版本： 11

Camera_FocusState

typedef enum Camera_FocusState Camera_FocusState

描述

焦点状态的枚举。

起始版本： 11

Camera_Format

typedef enum Camera_Format Camera_Format

描述

相机格式类型的枚举。

起始版本： 11

Camera_FrameRateRange

typedef struct Camera_FrameRateRange Camera_FrameRateRange

描述

帧速率范围。

起始版本： 11

Camera_FrameShutterEndInfo

typedef struct Camera_FrameShutterEndInfo Camera_FrameShutterEndInfo

描述

拍照曝光结束信息。

起始版本： 12

Camera_FrameShutterInfo

typedef struct Camera_FrameShutterInfo Camera_FrameShutterInfo

描述

帧快门回调信息。

起始版本： 11

Camera_HostDeviceType

typedef enum Camera_HostDeviceTypeCamera_HostDeviceType

描述

远程设备类型枚举。

起始版本： 15

Camera_ImageRotation

typedef enum Camera_ImageRotation Camera_ImageRotation

描述

图像旋转角度的枚举。

起始版本： 11

Camera_Input

typedef struct Camera_Input Camera_Input

描述

相机输入对象。

可以使用OH_CameraManager_CreateCameraInput方法创建指针。

起始版本： 11

Camera_Location

typedef struct Camera_Location Camera_Location

描述

拍照位置。

起始版本： 11

Camera_Manager

typedef struct Camera_Manager Camera_Manager

描述

相机管理器对象。

可以使用OH_Camera_GetCameraManager方法创建指针。

起始版本： 11

Camera_MetadataObject

typedef struct Camera_MetadataObject Camera_MetadataObject

描述

元数据对象基础。

起始版本： 11

Camera_MetadataObjectType

typedef enum Camera_MetadataObjectType Camera_MetadataObjectType

描述

元数据对象类型的枚举。

起始版本： 11

Camera_MetadataOutput

typedef struct Camera_MetadataOutput Camera_MetadataOutput

描述

元数据输出对象。

可以使用OH_CameraManager_CreateMetadataOutput方法创建指针。

起始版本： 11

Camera_OutputCapability

typedef struct Camera_OutputCapability Camera_OutputCapability

描述

相机输出能力。

起始版本： 11

Camera_PhotoCaptureSetting

typedef struct Camera_PhotoCaptureSetting Camera_PhotoCaptureSetting

描述

要设置的拍照捕获选项。

起始版本： 11

Camera_PhotoOutput

typedef struct Camera_PhotoOutput Camera_PhotoOutput

描述

拍照输出对象。

可以使用OH_CameraManager_CreatePhotoOutput方法创建指针。

起始版本： 11

Camera_Point

typedef struct Camera_Point Camera_Point

描述

点参数。

起始版本： 11

Camera_Position

typedef enum Camera_Position Camera_Position

描述

相机位置的枚举。

起始版本： 11

Camera_PreconfigRatio

typedef enum Camera_PreconfigRatio Camera_PreconfigRatio

描述

预配置照片比例的枚举。

起始版本： 12

Camera_PreconfigType

typedef enum Camera_PreconfigType Camera_PreconfigType

描述

预配置照片分辨率的枚举。

起始版本： 12

Camera_PreviewOutput

typedef struct Camera_PreviewOutput Camera_PreviewOutput

描述

预览输出对象。

可以使用OH_CameraManager_CreatePreviewOutput方法创建指针。

起始版本： 11

Camera_Profile

typedef struct Camera_Profile Camera_Profile

描述

相机流的配置文件。

起始版本： 11

Camera_QualityLevel

typedef enum Camera_QualityLevel Camera_QualityLevel

描述

图像质量等级的枚举。

起始版本： 11

Camera_QualityPrioritization

typedef enum Camera_QualityPrioritization Camera_QualityPrioritization

描述

录像质量优先级的枚举。

起始版本： 14

Camera_Rect

typedef struct Camera_Rect Camera_Rect

描述

矩形定义。

起始版本： 11

Camera_SceneMode

typedef enum Camera_SceneMode Camera_SceneMode

描述

相机模式的枚举。

起始版本： 12

Camera_Size

typedef struct Camera_Size Camera_Size

描述

大小参数。

起始版本： 11

Camera_SmoothZoomInfo

typedef struct Camera_SmoothZoomInfo Camera_SmoothZoomInfo

描述

平滑变焦参数信息。

起始版本： 12

Camera_SmoothZoomMode

typedef enum Camera_SmoothZoomMode Camera_SmoothZoomMode

描述

平滑变焦模式的枚举。

起始版本： 12

Camera_Status

typedef enum Camera_Status Camera_Status

描述

相机状态的枚举。

起始版本： 11

Camera_StatusInfo

typedef struct Camera_StatusInfo Camera_StatusInfo

描述

相机状态信息。

起始版本： 11

Camera_TorchMode

typedef enum Camera_TorchMode Camera_TorchMode

描述

手电筒模式的枚举。

起始版本： 12

Camera_TorchStatusInfo

typedef struct Camera_TorchStatusInfo Camera_TorchStatusInfo

描述

手电筒状态信息。

起始版本： 12

Camera_Type

typedef enum Camera_Type Camera_Type

描述

相机类型的枚举。

起始版本： 11

Camera_VideoOutput

typedef struct Camera_VideoOutput Camera_VideoOutput

描述

录像输出对象。

可以使用OH_CameraManager_CreateVideoOutput方法创建指针。

起始版本： 11

Camera_VideoProfile

typedef struct Camera_VideoProfile Camera_VideoProfile

描述

录像配置文件。

起始版本： 11

Camera_VideoStabilizationMode

typedef enum Camera_VideoStabilizationMode Camera_VideoStabilizationMode

描述

录像防抖模式的枚举。

起始版本： 11

CameraInput_Callbacks

typedef struct CameraInput_Callbacks CameraInput_Callbacks

描述

相机输入错误事件的回调。

起始版本： 11

参见：

OH_CameraInput_RegisterCallback

CameraManager_Callbacks

typedef struct CameraManager_Callbacks CameraManager_Callbacks

描述

相机设备状态的回调。

起始版本： 11

参见：

OH_CameraManager_RegisterCallback

CaptureSession_Callbacks

typedef struct CaptureSession_Callbacks CaptureSession_Callbacks

描述

捕获会话的回调。

起始版本： 11

参见：

OH_CaptureSession_RegisterCallback

MetadataOutput_Callbacks

typedef struct MetadataOutput_Callbacks MetadataOutput_Callbacks

描述

元数据输出的回调。

起始版本： 11

参见：

OH_MetadataOutput_RegisterCallback

OH_CameraInput_OnError

typedef void (*OH_CameraInput_OnError)(const Camera_Input* cameraInput, Camera_ErrorCode errorCode)

描述

在CameraInput_Callbacks中被调用的相机输入错误回调。

起始版本： 11

参数:

名称	描述
cameraInput	传递回调的Camera_Input。
errorCode	相机输入的Camera_ErrorCode。

参见：

Camera_ErrorCode中的：

• CAMERA_CONFLICT_CAMERA

• CAMERA_DEVICE_DISABLED

• CAMERA_DEVICE_PREEMPTED

• CAMERA_SERVICE_FATAL_ERROR

OH_CameraManager_StatusCallback

typedef void (*OH_CameraManager_StatusCallback)(Camera_Manager* cameraManager, Camera_StatusInfo* status)

描述

在CameraManager_Callbacks中被调用的相机管理器状态回调。

起始版本： 11

参数:

名称	描述
cameraManager	传递回调的Camera_Manager。
status	每个相机设备的Camera_StatusInfo。

OH_CameraManager_TorchStatusCallback

typedef void (*OH_CameraManager_TorchStatusCallback)(Camera_Manager* cameraManager, Camera_TorchStatusInfo* status)

描述

手电筒状态变化回调。

起始版本： 12

参数:

名称	描述
cameraManager	传递回调的Camera_Manager。
status	手电筒的状态Camera_TorchStatusInfo。

OH_CaptureSession_OnError

typedef void (*OH_CaptureSession_OnError)(Camera_CaptureSession* session, Camera_ErrorCode errorCode)

描述

在CaptureSession_Callbacks中被调用的捕获会话错误回调。

起始版本： 11

参数:

名称	描述
session	传递回调的Camera_CaptureSession。
errorCode	捕获会话的Camera_ErrorCode。

参见：

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR。

OH_CaptureSession_OnFocusStateChange

typedef void (*OH_CaptureSession_OnFocusStateChange)(Camera_CaptureSession* session, Camera_FocusState focusState)

描述

在CaptureSession_Callbacks中被调用的捕获会话焦点状态回调。

起始版本： 11

参数:

名称	描述
session	传递回调的Camera_CaptureSession。
focusState	回调传递的Camera_FocusState。

OH_CaptureSession_OnSmoothZoomInfo

typedef void (*OH_CaptureSession_OnSmoothZoomInfo)(Camera_CaptureSession* session, Camera_SmoothZoomInfo* smoothZoomInfo)

描述

拍照会话平滑变焦信息回调，触发平滑变焦后该回调会返回。

起始版本： 12

参数:

名称	描述
session	传递回调的Camera_CaptureSession。
smoothZoomInfo	回调传递的Camera_SmoothZoomInfo。

OH_MetadataOutput_OnError

typedef void (*OH_MetadataOutput_OnError)(Camera_MetadataOutput* metadataOutput, Camera_ErrorCode errorCode)

描述

在MetadataOutput_Callbacks中被调用的元数据输出错误回调。

起始版本： 11

参数:

名称	描述
metadataOutput	传递回调的Camera_MetadataOutput。
errorCode	元数据输出的Camera_ErrorCode。

参见：

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR。

OH_MetadataOutput_OnMetadataObjectAvailable

typedef void (*OH_MetadataOutput_OnMetadataObjectAvailable)(Camera_MetadataOutput* metadataOutput, Camera_MetadataObject* metadataObject, uint32_t size)

描述

在MetadataOutput_Callbacks中被调用的元数据输出元数据对象可用回调。

起始版本： 11

参数:

名称	描述
metadataOutput	传递回调的Camera_MetadataOutput。
metadataObject	Camera_MetadataObject将由回调传递。
size	元数据对象的大小。

OH_PhotoNative

typedef struct OH_PhotoNative OH_PhotoNative

描述

相机照片对象。

全质量图对象。

起始版本： 12

OH_PhotoOutput_CaptureEnd

typedef void (*OH_PhotoOutput_CaptureEnd) (Camera_PhotoOutput* photoOutput, int32_t frameCount)

描述

拍照结束回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
frameCount	回调传递的帧数。

OH_PhotoOutput_CaptureReady

typedef void (*OH_PhotoOutput_CaptureReady) (Camera_PhotoOutput* photoOutput)

描述

拍照准备就绪回调。收到回调后，可以继续进行下一次拍照。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。

OH_PhotoOutput_CaptureStartWithInfo

typedef void (*OH_PhotoOutput_CaptureStartWithInfo) (Camera_PhotoOutput* photoOutput, Camera_CaptureStartInfo* Info)

描述

拍照开始回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
Info	回调传递的Camera_CaptureStartInfo。

OH_PhotoOutput_EstimatedCaptureDuration

typedef void (*OH_PhotoOutput_EstimatedCaptureDuration) (Camera_PhotoOutput* photoOutput, int64_t duration)

描述

预计拍照时间回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
duration	回调传递的预计拍照时间。

OH_PhotoOutput_OnError

typedef void (*OH_PhotoOutput_OnError)(Camera_PhotoOutput* photoOutput, Camera_ErrorCode errorCode)

描述

在PhotoOutput_Callbacks中被调用的拍照输出错误回调。

起始版本： 11

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
errorCode	拍照输出的Camera_ErrorCode。

参见：

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR。

OH_PhotoOutput_OnFrameEnd

typedef void (*OH_PhotoOutput_OnFrameEnd)(Camera_PhotoOutput* photoOutput, int32_t frameCount)

描述

在PhotoOutput_Callbacks中被调用的拍照输出帧结束回调。

起始版本： 11

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
frameCount	回调传递的帧计数。

OH_PhotoOutput_OnFrameShutter

typedef void (*OH_PhotoOutput_OnFrameShutter)(Camera_PhotoOutput* photoOutput, Camera_FrameShutterInfo* info)

描述

在PhotoOutput_Callbacks中被调用的拍照输出帧快门回调。

起始版本： 11

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
info	回调传递的Camera_FrameShutterInfo。

OH_PhotoOutput_OnFrameShutterEnd

typedef void (*OH_PhotoOutput_OnFrameShutterEnd) (Camera_PhotoOutput* photoOutput, Camera_FrameShutterInfo* Info)

描述

拍照曝光结束回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
Info	回调传递的Camera_FrameShutterInfo。

OH_PhotoOutput_OnFrameStart

typedef void(* OH_PhotoOutput_OnFrameStart) (Camera_PhotoOutput *photoOutput)

描述

在PhotoOutput_Callbacks中被调用的拍照输出帧启动回调。

起始版本： 11

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。

OH_PhotoOutput_PhotoAssetAvailable

typedef void (*OH_PhotoOutput_PhotoAssetAvailable)(Camera_PhotoOutput* photoOutput, OH_MediaAsset* photoAsset)

描述

输出照片资源可用回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
photoAsset	回调传递的OH_MediaAsset。

OH_PhotoOutput_PhotoAvailable

typedef void (*OH_PhotoOutput_PhotoAvailable)(Camera_PhotoOutput* photoOutput, OH_PhotoNative* photo)

描述

照片输出可用高分辨率图像回调。

起始版本： 12

参数:

名称	描述
photoOutput	传递回调的Camera_PhotoOutput。
photo	回调传递的OH_PhotoNative。

OH_PreviewOutput_OnError

typedef void (*OH_PreviewOutput_OnError)(Camera_PreviewOutput* previewOutput, Camera_ErrorCode errorCode)

描述

在PreviewOutput_Callbacks中被调用的预览输出帧错误回调。

起始版本： 11

参数:

名称	描述
previewOutput	传递回调的Camera_PreviewOutput。
errorCode	预览输出的Camera_ErrorCode。

参见：

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_PreviewOutput_OnFrameEnd

typedef void (*OH_PreviewOutput_OnFrameEnd)(Camera_PreviewOutput* previewOutput, int32_t frameCount)

描述

在PreviewOutput_Callbacks中被调用的预览输出帧结束回调。

起始版本： 11

参数:

名称	描述
previewOutput	传递回调的Camera_PreviewOutput。
frameCount	回调传递的帧计数。

OH_PreviewOutput_OnFrameStart

typedef void (*OH_PreviewOutput_OnFrameStart)(Camera_PreviewOutput* previewOutput)

描述

在PreviewOutput_Callbacks中被调用的预览输出帧开始回调。

起始版本： 11

参数:

名称	描述
previewOutput	传递回调的Camera_PreviewOutput。

OH_VideoOutput_OnError

typedef void (*OH_VideoOutput_OnError)(Camera_VideoOutput* videoOutput, Camera_ErrorCode errorCode)

描述

在VideoOutput_Callbacks中被调用的录像输出错误回调。

起始版本： 11

参数:

名称	描述
videoOutput	传递回调的Camera_VideoOutput。
errorCode	录像输出的Camera_ErrorCode。

参见：

Camera_ErrorCode中的CAMERA_SERVICE_FATAL_ERROR

OH_VideoOutput_OnFrameEnd

typedef void (*OH_VideoOutput_OnFrameEnd)(Camera_VideoOutput* videoOutput, int32_t frameCount)

描述

在VideoOutput_Callbacks中被调用的录像输出帧结束回调。

起始版本： 11

参数:

名称	描述
videoOutput	传递回调的Camera_VideoOutput。
frameCount	回调传递的帧计数。

OH_VideoOutput_OnFrameStart

typedef void (*OH_VideoOutput_OnFrameStart)(Camera_VideoOutput* videoOutput)

描述

在VideoOutput_Callbacks中被调用的录像输出帧开始回调。

起始版本： 11

参数:

名称	描述
videoOutput	传递回调的Camera_VideoOutput。

PhotoOutput_Callbacks

typedef struct PhotoOutput_Callbacks PhotoOutput_Callbacks

描述

拍照输出的回调。

起始版本： 11

参见：

OH_PhotoOutput_RegisterCallback

PreviewOutput_Callbacks

typedef struct PreviewOutput_Callbacks PreviewOutput_Callbacks

描述

用于预览输出的回调。

起始版本： 11

参见：

OH_PreviewOutput_RegisterCallback

VideoOutput_Callbacks

typedef struct VideoOutput_Callbacks VideoOutput_Callbacks

描述

用于录像输出的回调。

起始版本： 11

参见：

OH_VideoOutput_RegisterCallback

枚举类型说明

Camera_Connection

enum Camera_Connection

描述

相机连接类型的枚举。

起始版本： 11

枚举值	描述
CAMERA_CONNECTION_BUILT_IN	内置摄像头。
CAMERA_CONNECTION_USB_PLUGIN	使用USB连接的摄像头。
CAMERA_CONNECTION_REMOTE	远程摄像头。

Camera_ErrorCode

enum Camera_ErrorCode

描述

相机错误代码的枚举。

起始版本： 11

枚举值	描述
CAMERA_OK	相机结果正常。
CAMERA_INVALID_ARGUMENT	参数丢失或参数类型不正确。
CAMERA_OPERATION_NOT_ALLOWED	不允许操作。
CAMERA_SESSION_NOT_CONFIG	会话未配置。
CAMERA_SESSION_NOT_RUNNING	会话未运行。
CAMERA_SESSION_CONFIG_LOCKED	会话配置已锁定。
CAMERA_DEVICE_SETTING_LOCKED	设备设置已锁定。
CAMERA_CONFLICT_CAMERA	因冲突而无法使用相机。
CAMERA_DEVICE_DISABLED	由于安全原因，相机已禁用。
CAMERA_DEVICE_PREEMPTED	因被抢占而无法使用相机。
CAMERA_UNRESOLVED_CONFLICTS_WITH_CURRENT_CONFIGURATIONS	与当前配置存在冲突。 起始版本： 12
CAMERA_SERVICE_FATAL_ERROR	相机服务致命错误。比如没有相机权限、相机服务重启、跨进程调用异常等。

Camera_ExposureMode

enum Camera_ExposureMode

描述

曝光模式的枚举。

起始版本： 11

枚举值	描述
EXPOSURE_MODE_LOCKED	锁定曝光模式。
EXPOSURE_MODE_AUTO	自动曝光模式。
EXPOSURE_MODE_CONTINUOUS_AUTO	连续自动曝光。

Camera_FlashMode

enum Camera_FlashMode

描述

闪光模式的枚举。

起始版本： 11

枚举值	描述
FLASH_MODE_CLOSE	关闭模式。
FLASH_MODE_OPEN	打开模式。
FLASH_MODE_AUTO	自动模式。
FLASH_MODE_ALWAYS_OPEN	始终打开模式。

Camera_FocusMode

enum Camera_FocusMode

描述

聚焦模式的枚举。

起始版本： 11

枚举值	描述
FOCUS_MODE_MANUAL	手动模式。
FOCUS_MODE_CONTINUOUS_AUTO	连续自动模式。
FOCUS_MODE_AUTO	自动模式。
FOCUS_MODE_LOCKED	锁定模式。

Camera_FocusState

enum Camera_FocusState

描述

焦点状态的枚举。

起始版本： 11

枚举值	描述
FOCUS_STATE_SCAN	扫描状态。
FOCUS_STATE_FOCUSED	聚焦状态。
FOCUS_STATE_UNFOCUSED	非聚焦状态。

Camera_Format

enum Camera_Format

描述

相机格式类型的枚举。

起始版本： 11

枚举值	描述
CAMERA_FORMAT_RGBA_8888	RGBA 8888格式。
CAMERA_FORMAT_YUV_420_SP	YUV 420格式。
CAMERA_FORMAT_JPEG	JPEG格式。
CAMERA_FORMAT_YCBCR_P010	YCBCR P010 格式。 起始版本： 12
CAMERA_FORMAT_YCRCB_P010	YCRCB P010 格式。 起始版本： 12

Camera_HostDeviceType

enum Camera_HostDeviceType

描述

远程设备类型枚举。

起始版本： 15

枚举值	描述
HOST_DEVICE_TYPE_UNKNOWN_TYPE	未知设备类型。
HOST_DEVICE_TYPE_PHONE	手机设备。
HOST_DEVICE_TYPE_TABLET	平板设备。

Camera_ImageRotation

enum Camera_ImageRotation

描述

图像旋转角度的枚举。

起始版本： 11

枚举值	描述
IAMGE_ROTATION_0	捕获图像旋转0度。
IAMGE_ROTATION_90	捕获图像旋转90度。
IAMGE_ROTATION_180	捕获图像旋转180度。
IAMGE_ROTATION_270	捕获图像旋转270度。

Camera_MetadataObjectType

enum Camera_MetadataObjectType

描述

元数据对象类型的枚举。

起始版本： 11

枚举值	描述
FACE_DETECTION	人脸检测。

Camera_Position

enum Camera_Position

描述

相机位置的枚举。

起始版本： 11

枚举值	描述
CAMERA_POSITION_UNSPECIFIED	相对于设备屏幕没有固定的朝向的相机。
CAMERA_POSITION_BACK	后置。
CAMERA_POSITION_FRONT	前置。

Camera_PreconfigRatio

enum Camera_PreconfigRatio

描述

预配置照片比例的枚举。

起始版本： 12

枚举值	描述
PRECONFIG_RATIO_1_1	预配置照片比例为1:1。
PRECONFIG_RATIO_4_3	预配置照片比例为4:3。
PRECONFIG_RATIO_16_9	预配置照片比例为16:9。

Camera_PreconfigType

enum Camera_PreconfigType

描述

预配置照片分辨率的枚举。

起始版本： 12

枚举值	描述
PRECONFIG_720P	预配置照片分辨率为720P。
PRECONFIG_1080P	预配置照片分辨率为1080P。
PRECONFIG_4K	预配置照片分辨率为4K。
PRECONFIG_HIGH_QUALITY	预配置照片为高质量。

Camera_QualityLevel

enum Camera_QualityLevel

描述

图像质量等级的枚举。

起始版本： 11

枚举值	描述
QUALITY_LEVEL_HIGH	高图像质量。
QUALITY_LEVEL_MEDIUM	中等图像质量。
QUALITY_LEVEL_LOW	低图像质量。

Camera_QualityPrioritization

enum Camera_QualityPrioritization

描述

录像质量优先级的枚举。

起始版本： 14

枚举值	描述
HIGH_QUALITY	高录像质量。
POWER_BALANCE	功耗平衡的录像质量。

Camera_SceneMode

enum Camera_SceneMode

描述

相机模式的枚举。

起始版本： 12

枚举值	描述
NORMAL_PHOTO	普通拍照模式。
NORMAL_VIDEO	普通视频模式。
SECURE_PHOTO	安全相机模式。

Camera_SmoothZoomMode

enum Camera_SmoothZoomMode

描述

平滑变焦模式的枚举。

起始版本： 12

枚举值	描述
NORMAL	贝塞尔曲线模式。

Camera_Status

enum Camera_Status

描述

相机状态的枚举。

起始版本： 11

枚举值	描述
CAMERA_STATUS_APPEAR	显示状态。
CAMERA_STATUS_DISAPPEAR	消失状态。
CAMERA_STATUS_AVAILABLE	可用状态。
CAMERA_STATUS_UNAVAILABLE	不可用状态。

Camera_TorchMode

enum Camera_TorchMode

描述

手电筒模式的枚举。

起始版本： 12

枚举值	描述
OFF	设备手电筒常关。
ON	设备手电筒常开。
AUTO	设备手电筒自动模式，将根据环境光照水平打开手电筒。

Camera_Type

enum Camera_Type

描述

相机类型的枚举。

起始版本： 11

枚举值	描述
CAMERA_TYPE_DEFAULT	默认相机类型。
CAMERA_TYPE_WIDE_ANGLE	广角相机。
CAMERA_TYPE_ULTRA_WIDE	超广角相机。
CAMERA_TYPE_TELEPHOTO	长焦相机。
CAMERA_TYPE_TRUE_DEPTH	景深相机。

Camera_VideoStabilizationMode

enum Camera_VideoStabilizationMode

描述

录像防抖模式的枚举。

起始版本： 11

枚举值	描述
STABILIZATION_MODE_OFF	关闭录像防抖。
STABILIZATION_MODE_LOW	LOW模式提供基本的防抖效果。
STABILIZATION_MODE_MIDDLE	MIDDLE模式意味着通过算法可以获得比LOW模式更好的效果。
STABILIZATION_MODE_HIGH	HIGH模式意味着通过算法可以获得比MIDDLE模式更好的效果。
STABILIZATION_MODE_AUTO	自动选择模式，HDF相机可用。

函数说明

OH_Camera_DeleteCameraManager()

Camera_ErrorCode OH_Camera_DeleteCameraManager(Camera_Manager* cameraManager)

描述

删除CameraManager实例。

起始版本： 11

参数:

名称	描述
cameraManager	要删除的Camera_Manager实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_Camera_GetCameraManager()

Camera_ErrorCode OH_Camera_GetCameraManager(Camera_Manager** cameraManager)

描述

创建CameraManager实例。

起始版本： 11

参数:

名称	描述
cameraManager	如果方法调用成功，将创建输出Camera_Manager。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraDevice_GetCameraOrientation()

Camera_ErrorCode OH_CameraDevice_GetCameraOrientation(Camera_Device* camera, uint32_t* orientation)

描述

获取相机设备的传感器方向属性。

起始版本： 12

参数:

名称	描述
camera	Camera_Device 用来获取属性。
orientation	返回相机sensor角度属性。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：如果方法调用成功，则返回传感器方向属性。

• CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CameraInput_Close()

Camera_ErrorCode OH_CameraInput_Close(Camera_Input* cameraInput)

描述

关闭相机。

起始版本： 11

参数:

名称	描述
cameraInput	要关闭的Camera_Input实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraInput_Open()

Camera_ErrorCode OH_CameraInput_Open(Camera_Input* cameraInput)

描述

打开相机。

起始版本： 11

参数:

名称	描述
cameraInput	要打开的Camera_Input实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_CONFLICT_CAMERA：因冲突而无法使用相机。

• CAMERA_DEVICE_DISABLED：由于安全原因禁用了摄像头。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraInput_OpenSecureCamera()

Camera_ErrorCode OH_CameraInput_OpenSecureCamera(Camera_Input* cameraInput, uint64_t* secureSeqId)

描述

打开相机。

起始版本： 12

参数:

名称	描述
cameraInput	要打开的Camera_Input实例。
secureSeqId	表示安全摄像头的序列值。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_CONFLICT_CAMERA：因冲突而无法使用相机。

• CAMERA_DEVICE_DISABLED：由于安全原因禁用了摄像头。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraInput_RegisterCallback()

Camera_ErrorCode OH_CameraInput_RegisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)

描述

注册相机输入更改事件回调。

起始版本： 11

参数:

名称	描述
cameraInput	Camera_Input实例。
callback	要注册的CameraInput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraInput_Release()

Camera_ErrorCode OH_CameraInput_Release(Camera_Input* cameraInput)

描述

释放相机输入实例。

和OH_CameraInput_Close只需要调用其中一个，调用之后无须再调用OH_CameraInput_Close。

起始版本： 11

参数:

名称	描述
cameraInput	要释放的Camera_Input实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraInput_UnregisterCallback()

Camera_ErrorCode OH_CameraInput_UnregisterCallback(Camera_Input* cameraInput, CameraInput_Callbacks* callback)

描述

注销相机输入更改事件回调。

起始版本： 11

参数:

名称	描述
cameraInput	Camera_Input实例。
callback	要注销的CameraInput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_CreateCameraInput()

Camera_ErrorCode OH_CameraManager_CreateCameraInput(Camera_Manager* cameraManager, const Camera_Device* camera, Camera_Input** cameraInput)

描述

创建相机输入实例。

起始版本： 11

需要权限： ohos.permission.CAMERA

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
camera	用于创建Camera_Input的Camera_Device。
cameraInput	如果方法调用成功，将创建Camera_Input。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreateCameraInput_WithPositionAndType()

Camera_ErrorCode OH_CameraManager_CreateCameraInput_WithPositionAndType(Camera_Manager* cameraManager, Camera_Position position, Camera_Type type, Camera_Input** cameraInput)

描述

创建具有位置和类型的相机输入实例。

起始版本： 11

需要权限： ohos.permission.CAMERA

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
position	用于创建Camera_Input的Camera_Position。
type	用于创建Camera_Input的Camera_Type。
cameraInput	如果方法调用成功，将创建Camera_Input。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreateCaptureSession()

Camera_ErrorCode OH_CameraManager_CreateCaptureSession(Camera_Manager* cameraManager,
 Camera_CaptureSession** captureSession)

描述

创建捕获会话实例。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
captureSession	如果方法调用成功，则将创建Camera_CaptureSession。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreateMetadataOutput()

Camera_ErrorCode OH_CameraManager_CreateMetadataOutput(Camera_Manager* cameraManager, const Camera_MetadataObjectType* profile, Camera_MetadataOutput** metadataOutput)

描述

创建元数据输出实例。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
profile	用于创建Camera_MetadataOutput的Camera_MetadataObjectType.
metadataOutput	如果方法调用成功，将创建Camera_MetadataOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreatePhotoOutput()

Camera_ErrorCode OH_CameraManager_CreatePhotoOutput(Camera_Manager* cameraManager, const Camera_Profile* profile, const char* surfaceId, Camera_PhotoOutput** photoOutput)

描述

创建一个拍照输出实例。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
profile	用于创建Camera_PhotoOutput的Camera_Profile。
surfaceId	用于创建Camera_PhotoOutput的surfaceId。
photoOutput	如果方法调用成功，将创建Camera_PhotoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreatePhotoOutputUsedInPreconfig()

Camera_ErrorCode OH_CameraManager_CreatePhotoOutputUsedInPreconfig(Camera_Manager* cameraManager, const char* surfaceId, Camera_PhotoOutput** photoOutput)

描述

创建在预配置流中使用的照片输出实例。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
surfaceId	用于创建Camera_PhotoOutput的surfaceId。
photoOutput	如果方法调用成功，将创建Camera_PhotoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreatePhotoOutputWithoutSurface()

Camera_ErrorCode OH_CameraManager_CreatePhotoOutputWithoutSurface(Camera_Manager *cameraManager, const Camera_Profile *profile, Camera_PhotoOutput **photoOutput)

描述

创建照片输出实例，调用此函数不需要surfaceId。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
profile	用于创建Camera_PhotoOutput的Camera_Profile。
photoOutput	如果方法调用成功，将创建Camera_PhotoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreatePreviewOutput()

Camera_ErrorCode OH_CameraManager_CreatePreviewOutput(Camera_Manager* cameraManager, const Camera_Profile* profile, const char* surfaceId, Camera_PreviewOutput** previewOutput)

描述

创建预览输出实例。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
profile	用于创建Camera_PreviewOutput的Camera_Profile。
surfaceId	用于创建Camera_PreviewOutput的surfaceId。
previewOutput	如果方法调用成功，将创建Camera_PreviewOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreatePreviewOutputUsedInPreconfig()

Camera_ErrorCode OH_CameraManager_CreatePreviewOutputUsedInPreconfig(Camera_Manager* cameraManager, const char* surfaceId, Camera_PreviewOutput** previewOutput)

描述

创建在预配置流中使用的预览输出实例。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
surfaceId	用于创建Camera_PreviewOutput的surfaceId。
previewOutput	如果方法调用成功，将创建Camera_PreviewOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreateVideoOutput()

Camera_ErrorCode OH_CameraManager_CreateVideoOutput(Camera_Manager* cameraManager, const Camera_VideoProfile* profile, const char* surfaceId, Camera_VideoOutput** videoOutput)

描述

创建一个录像输出实例。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
profile	用于创建Camera_VideoOutput的Camera_VideoProfile。
surfaceId	用于创建Camera_VideoOutput的surfaceId。
videoOutput	如果方法调用成功，将创建Camera_VideoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_CreateVideoOutputUsedInPreconfig()

Camera_ErrorCode OH_CameraManager_CreateVideoOutputUsedInPreconfig(Camera_Manager* cameraManager, const char* surfaceId, Camera_VideoOutput** videoOutput)

描述

创建在预配置流中使用的视频输出实例。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
surfaceId	用于创建Camera_VideoOutput的surfaceId。
videoOutput	如果方法调用成功，将创建Camera_VideoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_DeleteSceneModes()

Camera_ErrorCode OH_CameraManager_DeleteSceneModes(Camera_Manager* cameraManager, Camera_SceneMode* sceneModes)

描述

删除场景模式。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
sceneModes	要删除的Camera_SceneMode列表。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_DeleteSupportedCameraOutputCapability()

Camera_ErrorCode OH_CameraManager_DeleteSupportedCameraOutputCapability(Camera_Manager* cameraManager, Camera_OutputCapability* cameraOutputCapability)

描述

删除支持的输出功能。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
cameraOutputCapability	要删除的Camera_OutputCapability。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_DeleteSupportedCameras()

Camera_ErrorCode OH_CameraManager_DeleteSupportedCameras(Camera_Manager* cameraManager, Camera_Device* cameras, uint32_t size)

描述

删除支持的相机。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
cameras	要删除的Camera_Device列表。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_GetSupportedCameraOutputCapability()

Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapability(Camera_Manager* cameraManager, const Camera_Device* camera, Camera_OutputCapability** cameraOutputCapability)

描述

查询指定相机在指定模式下支持的输出能力。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
cameras	要查询的Camera_Device。
cameraOutputCapability	如果方法调用成功，则将记录支持的Camera_OutputCapability。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_GetSupportedCameraOutputCapabilityWithSceneMode()

Camera_ErrorCode OH_CameraManager_GetSupportedCameraOutputCapabilityWithSceneMode(Camera_Manager* cameraManager, const Camera_Device* camera, Camera_SceneMode sceneMode, Camera_OutputCapability** cameraOutputCapability)

描述

查询指定相机在指定模式下支持的输出能力。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
camera	被查询的Camera_Device。
sceneMode	指定相机模式Camera_SceneMode。
cameraOutputCapability	如果方法调用成功，则将记录支持的Camera_OutputCapability列表。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_GetSupportedCameras()

Camera_ErrorCode OH_CameraManager_GetSupportedCameras(Camera_Manager* cameraManager, Camera_Device** cameras, uint32_t* size)

描述

获取支持相机的描述。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
cameras	如果方法调用成功，则将记录支持的Camera_Device列表。
size	如果方法调用成功，则将记录支持的Camera_Device列表的大小。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_GetSupportedSceneModes()

Camera_ErrorCode OH_CameraManager_GetSupportedSceneModes(Camera_Device* camera, Camera_SceneMode** sceneModes, uint32_t* size)

描述

获取特定相机支持的场景模式。

起始版本： 12

参数:

名称	描述
camera	要查询的Camera_Device。
sceneModes	如果方法调用成功，则将记录支持的Camera_SceneMode列表。
size	如果方法调用成功，则将记录支持的Camera_SceneMode的列表大小。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_IsCameraMuted()

Camera_ErrorCode OH_CameraManager_IsCameraMuted(Camera_Manager* cameraManager, bool* isCameraMuted)

描述

确定相机是否静音。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
isCameraMuted	如果方法调用成功，将判断相机是否静音。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_IsTorchSupported()

Camera_ErrorCode OH_CameraManager_IsTorchSupported(Camera_Manager* cameraManager, bool* isTorchSupported)

描述

检查设备是否支持手电筒。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
isTorchSupported	设备是否支持手电筒。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_IsTorchSupportedByTorchMode()

Camera_ErrorCode OH_CameraManager_IsTorchSupportedByTorchMode(Camera_Manager* cameraManager, Camera_TorchMode torchMode, bool* isTorchSupported)

描述

检查设备是否支持指定的手电筒模式。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
torchMode	要检查的Camera_TorchMode。
isTorchSupported	设备是否支持指定的手电筒模式。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_RegisterCallback()

Camera_ErrorCode OH_CameraManager_RegisterCallback(Camera_Manager* cameraManager, CameraManager_Callbacks* callback)

描述

注册相机状态更改事件回调。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
callback	要注册的CameraManager_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_RegisterTorchStatusCallback()

Camera_ErrorCode OH_CameraManager_RegisterTorchStatusCallback(Camera_Manager* cameraManager, OH_CameraManager_TorchStatusCallback torchStatusCallback)

描述

注册手电筒状态变更事件回调。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
torchStatusCallback	要注册的OH_CameraManager_TorchStatusCallback。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_SetTorchMode()

Camera_ErrorCode OH_CameraManager_SetTorchMode(Camera_Manager* cameraManager, Camera_TorchMode torchMode)

描述

设置相机手电筒模式。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
torchMode	要设置的Camera_TorchMode。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：如果相机服务出现致命错误。

OH_CameraManager_UnregisterCallback()

Camera_ErrorCode OH_CameraManager_UnregisterCallback(Camera_Manager* cameraManager, CameraManager_Callbacks* callback)

描述

注销摄像机状态更改事件回调。

起始版本： 11

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
callback	要注销的CameraManager_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraManager_UnregisterTorchStatusCallback()

Camera_ErrorCode OH_CameraManager_UnregisterTorchStatusCallback(Camera_Manager* cameraManager, OH_CameraManager_TorchStatusCallback torchStatusCallback)

描述

注销手电筒状态变更事件回调。

起始版本： 12

参数:

名称	描述
cameraManager	相机管理器实例Camera_Manager。
torchStatusCallback	要注销的OH_CameraManager_TorchStatusCallback。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_AddInput()

Camera_ErrorCode OH_CaptureSession_AddInput(Camera_CaptureSession* session, Camera_Input* cameraInput)

描述

添加相机输入。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraInput	要添加的目标Camera_Input。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
metadataOutput	要添加的目标Camera_MetadataOutput。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
photoOutput	要添加的目标Camera_PhotoOutput。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
previewOutput	要添加的目标Camera_PreviewOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

OH_CaptureSession_AddSecureOutput()

Camera_ErrorCode OH_CaptureSession_AddSecureOutput(Camera_CaptureSession* session, Camera_PreviewOutput* previewOutput)

描述

把其中一条PreviewOutput标记成安全输出。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
previewOutput	要标记为安全输出的Camera_PreviewOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

• CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。

OH_CaptureSession_AddVideoOutput()

Camera_ErrorCode OH_CaptureSession_AddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* videoOutput)

描述

添加录像输出。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
videoOutput	要添加的目标Camera_VideoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

OH_CaptureSession_BeginConfig()

Camera_ErrorCode OH_CaptureSession_BeginConfig(Camera_CaptureSession* session)

描述

开始捕获会话配置。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

OH_CaptureSession_CanAddInput()

Camera_ErrorCode OH_CaptureSession_CanAddInput(Camera_CaptureSession* session, Camera_Input* cameraInput, bool* isSuccessful)

描述

确定是否可以将相机输入添加到会话中。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraInput	要设置的Camera_Input。
isSuccessful	是否可以将相机输入添加到会话中的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_CanAddPhotoOutput()

Camera_ErrorCode OH_CaptureSession_CanAddPhotoOutput(Camera_CaptureSession* session, Camera_PhotoOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将相机照片输出添加到会话中。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraOutput	要设置的Camera_PhotoOutput。
isSuccessful	相机照片输出是否可以添加到会话中的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_CanAddPreviewOutput()

Camera_ErrorCode OH_CaptureSession_CanAddPreviewOutput(Camera_CaptureSession* session, Camera_PreviewOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将相机预览输出添加到会话中。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraOutput	要设置的Camera_PreviewOutput。
isSuccessful	是否可以将相机预览输出添加到会话中的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_CanAddVideoOutput()

Camera_ErrorCode OH_CaptureSession_CanAddVideoOutput(Camera_CaptureSession* session, Camera_VideoOutput* cameraOutput, bool* isSuccessful)

描述

确定是否可以将相机视频输出添加到会话中。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraOutput	要添加的Camera_VideoOutput。
isSuccessful	相机视频输出是否可以添加到会话中的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_CanPreconfig()

Camera_ErrorCode OH_CaptureSession_CanPreconfig(Camera_CaptureSession* session, Camera_PreconfigType preconfigType, bool* canPreconfig)

描述

检查是否支持指定的预配置类型。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
preconfigType	要检查的预配置类型Camera_PreconfigType。
canPreconfig	是否支持预配置的结果。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
preconfigType	要检查支持的类型Camera_PreconfigType。
preconfigRatio	要检查支持的比例Camera_PreconfigRatio。
canPreconfig	是否支持预配置的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_CommitConfig()

Camera_ErrorCode OH_CaptureSession_CommitConfig(Camera_CaptureSession* session)

描述

提交捕获会话配置。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_DeleteColorSpaces()

Camera_ErrorCode OH_CaptureSession_DeleteColorSpaces(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace* colorSpace)

描述

删除色彩空间列表。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
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

参数:

名称	描述
session	Camera_CaptureSession实例。
colorSpace	当前的OH_NativeBuffer_ColorSpace。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureBias	当前的曝光补偿。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_GetExposureBiasRange()

Camera_ErrorCode OH_CaptureSession_GetExposureBiasRange(Camera_CaptureSession* session, float* minExposureBias, float* maxExposureBias, float* step)

描述

查询曝光补偿范围。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
minExposureBias	曝光补偿的最小值。
maxExposureBias	曝光补偿的最大值。
step	每个级别之间的曝光补偿阶梯。

返回：

错误码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)

描述

获取当前曝光模式。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureMode	当前的Camera_ExposureMode。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_GetExposureValue()

Camera_ErrorCode OH_CaptureSession_GetExposureValue(Camera_CaptureSession* session, float* exposureValue)

描述

查询曝光值。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureValue	当前的曝光值。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_GetFlashMode()

Camera_ErrorCode OH_CaptureSession_GetFlashMode(Camera_CaptureSession* session, Camera_FlashMode* flashMode)

描述

获取当前闪光灯模式。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
flashMode	当前Camera_FlashMode。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_GetFocalLength()

Camera_ErrorCode OH_CaptureSession_GetFocalLength(Camera_CaptureSession* session, float* focalLength)

描述

获取当前焦距值。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
focalLength	当前焦距值。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureBias	当前Camera_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

参数:

名称	描述
session	Camera_CaptureSession实例。
focusPoint	当前Camera_Point。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
point	当前Camera_Point测量点。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
colorSpace	如果方法调用成功，则将记录支持的OH_NativeBuffer_ColorSpace列表。
size	如果方法调用成功，则将记录支持的OH_NativeBuffer_ColorSpace列表的大小。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
mode	当前Camera_VideoStabilizationMode。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
zoom	当前缩放比例。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
minZoom	缩放比范围的最小值。
maxZoom	缩放比例范围的最大值。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_HasFlash()

Camera_ErrorCode OH_CaptureSession_HasFlash(Camera_CaptureSession* session, bool* hasFlash)

描述

检查设备是否有闪光灯。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
hasFlash	是否支持闪光灯的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_IsExposureModeSupported()

Camera_ErrorCode OH_CaptureSession_IsExposureModeSupported(Camera_CaptureSession* session, Camera_ExposureMode exposureMode, bool* isSupported)

描述

检查是否支持指定的曝光模式。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureMode	要检查的Camera_ExposureMode。
isSupported	是否支持曝光模式的结果。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
flashMode	要检查的Camera_FlashMode。
isSupported	是否支持闪光灯模式的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_IsFocusModeSupported()

Camera_ErrorCode OH_CaptureSession_IsFocusModeSupported(Camera_CaptureSession* session, Camera_FocusMode focusMode, bool* isSupported)

描述

检查是否支持指定的聚焦模式。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
focusMode	要检查的Camera_FocusMode。
isSupported	是否支持聚焦模式的结果。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
mode	要检查的Camera_VideoStabilizationMode。
isSupported	是否支持录像防抖模式的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_Preconfig()

Camera_ErrorCode OH_CaptureSession_Preconfig(Camera_CaptureSession* session, Camera_PreconfigType preconfigType)

描述

设置预配置类型。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
preconfigType	要检查支持的类型Camera_PreconfigType。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_PreconfigWithRatio()

Camera_ErrorCode OH_CaptureSession_PreconfigWithRatio(Camera_CaptureSession* session, Camera_PreconfigType preconfigType, Camera_PreconfigRatio preconfigRatio)

描述

设置带有比例的预配置类型。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
preconfigType	要检查支持的类型Camera_PreconfigType。
preconfigRatio	要检查支持的比例Camera_PreconfigRatio。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_RegisterCallback()

Camera_ErrorCode OH_CaptureSession_RegisterCallback(Camera_CaptureSession* session, CaptureSession_Callbacks* callback)

描述

注册捕获会话事件回调。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
callback	要注册的CaptureSession_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_RegisterSmoothZoomInfoCallback()

Camera_ErrorCode OH_CaptureSession_RegisterSmoothZoomInfoCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)

描述

注册平滑变焦信息事件回调。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
smoothZoomInfoCallback	要注册的OH_CaptureSession_OnSmoothZoomInfo。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_Release()

Camera_ErrorCode OH_CaptureSession_Release(Camera_CaptureSession* session)

描述

释放捕获会话。

起始版本： 11

参数:

名称	描述
session	要释放的Camera_CaptureSession实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_RemoveInput()

Camera_ErrorCode OH_CaptureSession_RemoveInput(Camera_CaptureSession* session, Camera_Input* cameraInput)

描述

删除相机输入。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
cameraInput	要删除的目标Camera_Input。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
metadataOutput	要删除的目标Camera_MetadataOutput。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
photoOutput	要删除的目标Camera_PhotoOutput。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
previewOutput	要删除的目标Camera_PreviewOutput。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
videoOutput	要删除的目标Camera_VideoOutput。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

OH_CaptureSession_SetActiveColorSpace()

Camera_ErrorCode OH_CaptureSession_SetActiveColorSpace(Camera_CaptureSession* session, OH_NativeBuffer_ColorSpace colorSpace)

描述

设置当前色彩空间。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
colorSpace	要设置的目标OH_NativeBuffer_ColorSpace。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureBias	要设置的目标曝光补偿。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
exposureMode	要设置的目标Camera_ExposureMode。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
flashMode	要设置的目标Camera_FlashMode。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
focusMode	要设置的目标Camera_FocusMode。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
focusPoint	要设置的目标Camera_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

参数:

名称	描述
session	Camera_CaptureSession实例。
point	要设置的目标Camera_Point。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_SetQualityPrioritization()

Camera_ErrorCode OH_CaptureSession_SetQualityPrioritization(Camera_CaptureSession* session, Camera_QualityPrioritization qualityPrioritization)

描述

设置录像质量优先级。

说明： 默认为高质量，设置为功耗平衡将降低录像质量以减少功耗。实际功耗收益因平台而异。

起始版本： 14

参数:

名称	描述
session	Camera_CaptureSession实例。
qualityPrioritization	要设置的质量优先级Camera_QualityPrioritization （默认为高质量）。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_SetSessionMode()

Camera_ErrorCode OH_CaptureSession_SetSessionMode(Camera_CaptureSession* session, Camera_SceneMode sceneMode)

描述

设置会话模式。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
sceneMode	Camera_SceneMode实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

• CAMERA_OPERATION_NOT_ALLOWED：不允许操作。

• CAMERA_SESSION_CONFIG_LOCKED：会话配置已锁定。

OH_CaptureSession_SetSmoothZoom()

Camera_ErrorCode OH_CaptureSession_SetSmoothZoom(Camera_CaptureSession* session, float targetZoom, Camera_SmoothZoomMode smoothZoomMode)

描述

触发平滑变焦。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
targetZoom	要设置的目标变焦比。
smoothZoomMode	Camera_SmoothZoomMode实例。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
mode	要设置的目标Camera_VideoStabilizationMode。

返回：

错误码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

参数:

名称	描述
session	Camera_CaptureSession实例。
zoom	要设置的目标缩放比。 设置可变焦距比到底层生效需要一定时间，获取正确设置的可变焦距比需要等待1~2帧的时间。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

OH_CaptureSession_Start()

Camera_ErrorCode OH_CaptureSession_Start(Camera_CaptureSession* session)

描述

启动捕获会话。

起始版本： 11

参数:

名称	描述
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

参数:

名称	描述
session	要停止的Camera_CaptureSession实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CaptureSession_UnregisterCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterCallback(Camera_CaptureSession* session, CaptureSession_Callbacks* callback)

描述

注销捕获会话事件回调。

起始版本： 11

参数:

名称	描述
session	Camera_CaptureSession实例。
callback	要注销的CaptureSession_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CaptureSession_UnregisterSmoothZoomInfoCallback()

Camera_ErrorCode OH_CaptureSession_UnregisterSmoothZoomInfoCallback(Camera_CaptureSession* session, OH_CaptureSession_OnSmoothZoomInfo smoothZoomInfoCallback)

描述

注销平滑变焦信息事件回调。

起始版本： 12

参数:

名称	描述
session	Camera_CaptureSession实例。
smoothZoomInfoCallback	要注销的OH_CaptureSession_OnSmoothZoomInfo。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_MetadataOutput_RegisterCallback()

Camera_ErrorCode OH_MetadataOutput_RegisterCallback(Camera_MetadataOutput* metadataOutput, MetadataOutput_Callbacks* callback)

描述

注册元数据输出更改事件回调。

起始版本： 11

参数:

名称	描述
metadataOutput	Camera_MetadataOutput实例。
callback	要注册的MetadataOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_MetadataOutput_Release()

Camera_ErrorCode OH_MetadataOutput_Release(Camera_MetadataOutput* metadataOutput)

描述

释放元数据输出。

起始版本： 11

参数:

名称	描述
metadataOutput	要释放的Camera_MetadataOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_MetadataOutput_Start()

Camera_ErrorCode OH_MetadataOutput_Start(Camera_MetadataOutput* metadataOutput)

描述

启动元数据输出。

起始版本： 11

参数:

名称	描述
metadataOutput	要启动的Camera_MetadataOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_MetadataOutput_Stop()

Camera_ErrorCode OH_MetadataOutput_Stop(Camera_MetadataOutput* metadataOutput)

描述

停止元数据输出。

起始版本： 11

参数:

名称	描述
metadataOutput	要停止的Camera_MetadataOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_MetadataOutput_UnregisterCallback()

Camera_ErrorCode OH_MetadataOutput_UnregisterCallback(Camera_MetadataOutput* metadataOutput, MetadataOutput_Callbacks* callback)

描述

注销元数据输出更改事件回调。

起始版本： 11

参数:

名称	描述
metadataOutput	Camera_MetadataOutput实例。
callback	要注销的MetadataOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoNative_GetMainImage()

Camera_ErrorCode OH_PhotoNative_GetMainImage(OH_PhotoNative* photo, OH_ImageNative** mainImage)

描述

获取全质量图。

起始版本： 12

参数:

名称	描述
photo	OH_PhotoNative实例。
mainImage	用于获取全质量图的OH_ImageNative。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoNative_Release()

Camera_ErrorCode OH_PhotoNative_Release(OH_PhotoNative* photo)

描述

释放全质量图实例。

起始版本： 12

参数:

名称	描述
photo	要被释放的OH_PhotoNative实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_Capture()

Camera_ErrorCode OH_PhotoOutput_Capture(Camera_PhotoOutput* photoOutput)

描述

拍摄照片。

OH_PhotoOutput_Capture()必须在OH_PreviewOutput_Release()之前调用，否则会导致无法拍照。

起始版本： 11

参数:

名称	描述
photoOutput	用于捕获拍照的Camera_PhotoOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_RUNNING：捕获会话未运行。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_Capture_WithCaptureSetting()

Camera_ErrorCode OH_PhotoOutput_Capture_WithCaptureSetting(Camera_PhotoOutput* photoOutput, Camera_PhotoCaptureSetting setting)

描述

使用捕获设置捕获拍照。

起始版本： 11

参数:

名称	描述
photoOutput	用于捕获拍照的Camera_PhotoOutput实例。
setting	用于捕获拍照的Camera_PhotoCaptureSetting。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_RUNNING：捕获会话未运行。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_DeleteProfile()

Camera_ErrorCode OH_PhotoOutput_DeleteProfile(Camera_Profile* profile)

描述

删除照片配置文件实例。

起始版本： 12

参数:

名称	描述
profile	要被删除的Camera_Profile实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_EnableMovingPhoto()

Camera_ErrorCode OH_PhotoOutput_EnableMovingPhoto(Camera_PhotoOutput* photoOutput, bool enabled)

描述

是否启用动态照片。

起始版本： 12

需要权限： ohos.permission.MICROPHONE

参数:

名称	描述
photoOutput	用来启用或禁用动态照片的Camera_PhotoOutput实例。
enabled	是否启用动态照片。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_GetActiveProfile()

Camera_ErrorCode OH_PhotoOutput_GetActiveProfile(Camera_PhotoOutput* photoOutput, Camera_Profile** profile)

描述

获取当前照片输出配置文件。

起始版本： 12

参数:

名称	描述
photoOutput	传递当前配置文件的Camera_PhotoOutput实例。
profile	如果方法调用成功，则将记录Camera_Profile。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_IsMirrorSupported()

Camera_ErrorCode OH_PhotoOutput_IsMirrorSupported(Camera_PhotoOutput* photoOutput, bool* isSupported)

描述

检查是否支持镜像拍照。

起始版本： 11

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例，用于检查是否支持镜像。
isSupported	是否支持镜像的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_EnableMirror()

Camera_ErrorCode OH_PhotoOutput_EnableMirror(Camera_PhotoOutput* photoOutput, bool enabled)

描述

是否启用镜像拍照。

起始版本： 13

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例，用于是否启用镜像拍照。
enabled	是否启用镜像拍照的结果，true为开启镜像拍照，false为关闭镜像拍照。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_IsMovingPhotoSupported()

Camera_ErrorCode OH_PhotoOutput_IsMovingPhotoSupported(Camera_PhotoOutput* photoOutput, bool* isSupported)

描述

检查是否支持动态照片。

起始版本： 12

参数:

名称	描述
photoOutput	用来检查是否支持动态照片的Camera_PhotoOutput实例。
isSupported	是否支持动态照片的结果。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_RegisterCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterCallback(Camera_PhotoOutput* photoOutput, PhotoOutput_Callbacks* callback)

描述

注册拍照输出更改事件回调。

起始版本： 11

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的PhotoOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterCaptureEndCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterCaptureEndCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureEnd callback)

描述

注册拍照结束事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_CaptureEnd。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterCaptureReadyCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterCaptureReadyCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureReady callback)

描述

注册拍照就绪事件回调。收到回调后，可以继续进行下一次拍照。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_CaptureReady。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterCaptureStartWithInfoCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterCaptureStartWithInfoCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureStartWithInfo callback)

描述

注册拍照开始事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_CaptureStartWithInfo。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterEstimatedCaptureDurationCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterEstimatedCaptureDurationCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_EstimatedCaptureDuration callback)

描述

注册预计拍照时间事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_EstimatedCaptureDuration。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterFrameShutterEndCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterFrameShutterEndCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_OnFrameShutterEnd callback)

描述

注册拍照曝光结束事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_OnFrameShutterEnd。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterPhotoAssetAvailableCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterPhotoAssetAvailableCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_PhotoAssetAvailable callback)

描述

注册输出照片资源可用回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_PhotoAssetAvailable。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_RegisterPhotoAvailableCallback()

Camera_ErrorCode OH_PhotoOutput_RegisterPhotoAvailableCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_PhotoAvailable callback)

描述

注册输出照片可用回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注册的OH_PhotoOutput_PhotoAvailable。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_Release()

Camera_ErrorCode OH_PhotoOutput_Release(Camera_PhotoOutput* photoOutput)

描述

释放拍照输出。

起始版本： 11

参数:

名称	描述
photoOutput	要释放的Camera_PhotoOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PhotoOutput_UnregisterCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterCallback(Camera_PhotoOutput* photoOutput, PhotoOutput_Callbacks* callback)

描述

注销拍照输出更改事件回调。

起始版本： 11

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的PhotoOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterCaptureEndCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureEndCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureEnd callback)

描述

注销拍照结束事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_CaptureEnd。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterCaptureReadyCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureReadyCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureReady callback)

描述

注销拍照就绪事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_CaptureReady。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterCaptureStartWithInfoCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterCaptureStartWithInfoCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_CaptureStartWithInfo callback)

描述

注销拍照开始事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_CaptureStartWithInfo。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterEstimatedCaptureDurationCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterEstimatedCaptureDurationCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_EstimatedCaptureDuration callback)

描述

注销预计拍照时间事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_EstimatedCaptureDuration。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterFrameShutterEndCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterFrameShutterEndCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_OnFrameShutterEnd callback)

描述

注销拍照曝光结束事件回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_OnFrameShutterEnd。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterPhotoAssetAvailableCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterPhotoAssetAvailableCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_PhotoAssetAvailable callback)

描述

注销输出照片资源可用回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的OH_PhotoOutput_PhotoAssetAvailable。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PhotoOutput_UnregisterPhotoAvailableCallback()

Camera_ErrorCode OH_PhotoOutput_UnregisterPhotoAvailableCallback(Camera_PhotoOutput* photoOutput, OH_PhotoOutput_PhotoAvailable callback)

描述

注销输出照片可用回调。

起始版本： 12

参数:

名称	描述
photoOutput	Camera_PhotoOutput实例。
callback	要注销的PhotoOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_DeleteFrameRates()

Camera_ErrorCode OH_PreviewOutput_DeleteFrameRates(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange* frameRateRange)

描述

删除帧率列表。

起始版本： 12

参数:

名称	描述
previewOutput	Camera_PreviewOutput实例。
frameRateRange	要删除的Camera_FrameRateRange列表。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PreviewOutput_DeleteProfile()

Camera_ErrorCode OH_PreviewOutput_DeleteProfile(Camera_Profile* profile)

描述

删除预览配置文件实例。

起始版本： 12

参数:

名称	描述
profile	要被删除的Camera_Profile实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PreviewOutput_GetActiveFrameRate()

Camera_ErrorCode OH_PreviewOutput_GetActiveFrameRate(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange* frameRateRange)

描述

获取当前预览输出帧率。

起始版本： 12

参数:

名称	描述
previewOutput	传递当前预览输出帧率的Camera_PreviewOutput实例。
frameRateRange	如果方法调用成功，则将记录当前的Camera_FrameRateRange。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_GetActiveProfile()

Camera_ErrorCode OH_PreviewOutput_GetActiveProfile(Camera_PreviewOutput* previewOutput, Camera_Profile** profile)

描述

获取当前预览输出配置文件。

起始版本： 12

参数:

名称	描述
previewOutput	提供当前预览输出配置文件的Camera_PreviewOutput实例。
profile	如果方法调用成功，则将记录当前的Camera_Profile。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_GetSupportedFrameRates()

Camera_ErrorCode OH_PreviewOutput_GetSupportedFrameRates(Camera_PreviewOutput* previewOutput, Camera_FrameRateRange** frameRateRange, uint32_t* size)

描述

获取支持的预览输出帧率列表。

起始版本： 12

参数:

名称	描述
previewOutput	传递支持的帧率列表的Camera_PreviewOutput实例。
frameRateRange	如果方法调用成功，则将记录支持的Camera_FrameRateRange列表。
size	如果方法调用成功，则将记录支持的Camera_FrameRateRange列表大小。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_RegisterCallback()

Camera_ErrorCode OH_PreviewOutput_RegisterCallback(Camera_PreviewOutput* previewOutput, PreviewOutput_Callbacks* callback)

描述

注册预览输出更改事件回调。

起始版本： 11

参数:

名称	描述
previewOutput	Camera_PreviewOutput实例。
callback	要注册的PreviewOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PreviewOutput_Release()

Camera_ErrorCode OH_PreviewOutput_Release(Camera_PreviewOutput* previewOutput)

描述

释放预览输出。

起始版本： 11

参数:

名称	描述
previewOutput	要释放的Camera_PreviewOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_SetFrameRate()

Camera_ErrorCode OH_PreviewOutput_SetFrameRate(Camera_PreviewOutput* previewOutput, int32_t minFps, int32_t maxFps)

描述

设置预览输出帧率。

起始版本： 12

参数:

名称	描述
previewOutput	要设置帧率的Camera_PreviewOutput实例。
minFps	要设置的最小值。
maxFps	要设置的最大值。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_PreviewOutput_Start()

Camera_ErrorCode OH_PreviewOutput_Start(Camera_PreviewOutput* previewOutput)

描述

开始预览输出。

起始版本： 11

参数:

名称	描述
previewOutput	要启动的Camera_PreviewOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_Stop()

Camera_ErrorCode OH_PreviewOutput_Stop(Camera_PreviewOutput* previewOutput)

描述

停止预览输出。

起始版本： 11

参数:

名称	描述
previewOutput	要停止的Camera_PreviewOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_PreviewOutput_UnregisterCallback()

Camera_ErrorCode OH_PreviewOutput_UnregisterCallback(Camera_PreviewOutput* previewOutput, PreviewOutput_Callbacks* callback)

描述

注销预览输出更改事件回调。

起始版本： 11

参数:

名称	描述
previewOutput	Camera_PreviewOutput实例。
callback	要注销的PreviewOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_VideoOutput_DeleteFrameRates()

Camera_ErrorCode OH_VideoOutput_DeleteFrameRates(Camera_VideoOutput* videoOutput, Camera_FrameRateRange* frameRateRange)

描述

删除帧率列表。

起始版本： 12

参数:

名称	描述
videoOutput	Camera_VideoOutput实例。
frameRateRange	要删除的Camera_FrameRateRange列表。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_VideoOutput_DeleteProfile()

Camera_ErrorCode OH_VideoOutput_DeleteProfile(Camera_VideoProfile* profile)

描述

删除视频配置文件实例。

起始版本： 12

参数:

名称	描述
profile	要删除的Camera_VideoProfile实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_VideoOutput_EnableMirror()

Camera_ErrorCode OH_VideoOutput_EnableMirror(Camera_VideoOutput* videoOutput, bool mirrorMode)

描述

打开/关闭当前视频输出镜像功能。

起始版本： 15

参数:

名称	描述
videoOutput	传递当前视频输出的Camera_VideoOutput实例。
mirrorMode	TRUE表示打开镜像功能, FALSE表示关闭镜像功能。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。
• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_GetActiveFrameRate()

Camera_ErrorCode OH_VideoOutput_GetActiveFrameRate(Camera_VideoOutput* videoOutput, Camera_FrameRateRange* frameRateRange)

描述

获取当前视频输出帧率。

起始版本： 12

参数:

名称	描述
videoOutput	传递当前视频输出帧率的Camera_VideoOutput实例。
frameRateRange	如果方法调用成功，则将记录当前的Camera_FrameRateRange。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_GetActiveProfile()

Camera_ErrorCode OH_VideoOutput_GetActiveProfile(Camera_VideoOutput* videoOutput, Camera_VideoProfile** profile)

描述

获取当前视频输出配置文件。

起始版本： 12

参数:

名称	描述
videoOutput	传递当前视频输出配置文件的Camera_VideoOutput实例。
profile	如果方法调用成功，则将记录当前的Camera_VideoProfile。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_GetSupportedFrameRates()

Camera_ErrorCode OH_VideoOutput_GetSupportedFrameRates(Camera_VideoOutput* videoOutput, Camera_FrameRateRange** frameRateRange, uint32_t* size)

描述

获取支持的视频输出帧率列表。

起始版本： 12

参数:

名称	描述
videoOutput	传递支持的视频输出帧率列表的Camera_VideoOutput实例。
frameRateRange	如果方法调用成功，则将记录支持的Camera_FrameRateRange列表。
size	如果方法调用成功，则将记录支持的Camera_FrameRateRange列表大小。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_GetVideoRotation()

Camera_ErrorCode  OH_VideoOutput_GetVideoRotation(Camera_VideoOutput* videoOutput, int deviceDegree, Camera_ImageRotation* imageRotation)

描述

获取当前视频输出应当设置的旋转角度。

起始版本： 12

参数:

名称	描述
videoOutput	传递当前视频输出的Camera_VideoOutput实例。
deviceDegree	设备目前相对于自然方向（充电口朝下）顺时针的旋转角度。
imageRotation	当前视频输出应当设置的旋转角度。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。
• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_IsMirrorSupported()

Camera_ErrorCode OH_VideoOutput_IsMirrorSupported(Camera_VideoOutput* videoOutput, bool* isSupported)

描述

判断当前视频输出是否支持镜像。

起始版本： 15

参数:

名称	描述
videoOutput	传递当前视频输出的Camera_VideoOutput实例。
isSupported	当前视频输出是否支持镜像。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。
• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。
• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_RegisterCallback()

Camera_ErrorCode OH_VideoOutput_RegisterCallback(Camera_VideoOutput* videoOutput, VideoOutput_Callbacks* callback)

描述

注册录像输出更改事件回调。

起始版本： 11

参数:

名称	描述
videoOutput	Camera_VideoOutput实例。
callback	要注册的VideoOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_VideoOutput_Release()

Camera_ErrorCode OH_VideoOutput_Release(Camera_VideoOutput* videoOutput)

描述

释放录像输出。

起始版本： 11

参数:

名称	描述
videoOutput	要释放的Camera_VideoOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_SetFrameRate()

Camera_ErrorCode OH_VideoOutput_SetFrameRate(Camera_VideoOutput* videoOutput, int32_t minFps, int32_t maxFps)

描述

设置视频输出帧率。

起始版本： 12

参数:

名称	描述
videoOutput	要设置帧率的Camera_VideoOutput实例。
minFps	设置的最小帧率。
maxFps	设置的最大帧率。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_VideoOutput_Start()

Camera_ErrorCode OH_VideoOutput_Start(Camera_VideoOutput* videoOutput)

描述

开始录像输出。

起始版本： 11

参数:

名称	描述
videoOutput	要启动的Camera_VideoOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SESSION_NOT_CONFIG：捕获会话未配置。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_Stop()

Camera_ErrorCode OH_VideoOutput_Stop(Camera_VideoOutput* videoOutput)

描述

停止录像输出。

起始版本： 11

参数:

名称	描述
videoOutput	要停止的Camera_VideoOutput实例。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_VideoOutput_UnregisterCallback()

Camera_ErrorCode OH_VideoOutput_UnregisterCallback(Camera_VideoOutput* videoOutput, VideoOutput_Callbacks* callback)

描述

注销录像输出更改事件回调。

起始版本： 11

参数:

名称	描述
videoOutput	Camera_VideoOutput实例。
callback	要注销的VideoOutput_Callbacks。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功。

• CAMERA_INVALID_ARGUMENT：参数丢失或参数类型不正确。

OH_CameraDevice_GetHostDeviceName()

Camera_ErrorCode OH_CameraDevice_GetHostDeviceName(Camera_Device* camera, char** hostDeviceName)

描述

获取远程设备名称。

起始版本： 15

参数:

名称	描述
camera	用来获取属性的Camera_Device。
hostDeviceName	返回远程设备名称属性。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功，将返回远程设备名称属性。

• CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。

OH_CameraDevice_GetHostDeviceType()

Camera_ErrorCode OH_CameraDevice_GetHostDeviceType(Camera_Device* camera, Camera_HostDeviceType* hostDeviceType)

描述

获取远程设备类型。

起始版本： 15

参数:

名称	描述
camera	用来获取属性的Camera_Device。
hostDeviceType	返回远程设备类型属性Camera_HostDeviceType。

返回：

错误码Camera_ErrorCode：

• CAMERA_OK：方法调用成功，将返回远程设备名称属性。

• CAMERA_INVALID_ARGUMENT：参数丢失或者参数不正确。

• CAMERA_SERVICE_FATAL_ERROR：相机服务出现致命错误。