harmony 鸿蒙camera.h

2025-06-12
浏览 (3)

camera.h

概述

声明相机的基本概念。

库： libohcamera.so

引用文件：<ohcamera/camera.h>

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

起始版本： 11

相关模块：OH_Camera

汇总

结构体

名称	描述
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 Camera_ConcurrentInfo	相机并发能力信息。

类型定义

名称	描述
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_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 enum Camera_ConcurrentType Camera_ConcurrentType	相机并发状态的枚举。
typedef struct Camera_ConcurrentInfo Camera_ConcurrentInfo	相机并发能力信息。

枚举

名称	描述
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_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_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_ConcurrentType { CAMERA_CONCURRENT_TYPE_LIMITED_CAPABILITY = 0, CAMERA_CONCURRENT_TYPE_FULL_CAPABILITY = 1 }	相机并发状态的枚举。

函数

名称	描述
Camera_ErrorCode OH_Camera_GetCameraManager (Camera_Manager **cameraManager)	创建CameraManager实例。
Camera_ErrorCode OH_Camera_DeleteCameraManager (Camera_Manager *cameraManager)	删除CameraManager实例。