目录

camera.h

概述

定义相机的基本接口和功能。

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

库： libohcamera.so

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

起始版本： 11

相关模块： OH_Camera

汇总

[h2]结构体

名称 typedef关键字 描述
Camera_DeviceQueryInfo Camera_DeviceQueryInfo 相机设备的查询信息。
Camera_Size Camera_Size 大小参数。
Camera_Profile Camera_Profile 相机流的配置文件。
Camera_FrameRateRange Camera_FrameRateRange 帧速率范围。
Camera_VideoProfile Camera_VideoProfile 录像配置文件。
Camera_OutputCapability Camera_OutputCapability 相机输出能力。
Camera_Device Camera_Device 相机设备对象。
Camera_StatusInfo Camera_StatusInfo 相机状态信息。
Camera_Point Camera_Point 点参数。
Camera_Location Camera_Location 拍照位置。
Camera_PhotoCaptureSetting Camera_PhotoCaptureSetting 要设置的拍照捕获选项。
Camera_FrameShutterInfo Camera_FrameShutterInfo 帧快门回调信息。
Camera_CaptureEndInfo Camera_CaptureEndInfo 捕获结束信息。
Camera_Rect Camera_Rect

相机矩形。用于各类检测对象的矩形框绘制。

检测点坐标系以设备横向位置（充电口朝右）为基准。

坐标系原点位于左上角 (0, 0)，右下角对应相机预览流的像素分辨率。

所有参数均为整型像素值，其中topLeftX与topLeftY表示矩形左上角坐标，width与height分别表示矩形的宽高。
Camera_MetadataObject Camera_MetadataObject 元数据对象基础。
Camera_TorchStatusInfo Camera_TorchStatusInfo 手电筒状态信息。
Camera_SmoothZoomInfo Camera_SmoothZoomInfo 平滑变焦参数信息。
Camera_CaptureStartInfo Camera_CaptureStartInfo 拍照开始信息。
Camera_FrameShutterEndInfo Camera_FrameShutterEndInfo 拍照曝光结束信息。
Camera_FoldStatusInfo Camera_FoldStatusInfo 折叠状态信息。
Camera_AutoDeviceSwitchStatusInfo Camera_AutoDeviceSwitchStatusInfo 自动设备切换状态信息。
Camera_ConcurrentInfo Camera_ConcurrentInfo 相机并发能力信息。
Camera_ControlCenterStatusInfo Camera_ControlCenterStatusInfo 控制器效果激活状态信息。
Camera_OcclusionDetectionResult Camera_OcclusionDetectionResult 相机镜头遮挡、脏污检测结果。
OH_Camera_ZoomRange OH_Camera_ZoomRange 变焦范围配置。
OH_Camera_PhysicalAperture OH_Camera_PhysicalAperture 物理光圈配置。
OH_Camera_ZoomPointInfo OH_Camera_ZoomPointInfo 描述变焦点信息。
OH_Camera_Rect_Ext OH_Camera_Rect_Ext

矩形定义。

检测点应在0-1坐标系内，该坐标系左上角为(0，0)，右下角为(1，1)。

此坐标系以设备充电口在右侧时的横向设备方向为基准。

例如应用的预览界面布局以设备充电口在下侧时的竖向方向为基准，布局宽高为(w，h)，返回点为(x，y)，则转换后的坐标点为(1-y，x)。
Camera_Manager Camera_Manager

相机管理器对象。

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

[h2]枚举

名称 typedef关键字 描述
Camera_ErrorCode Camera_ErrorCode 相机错误代码的枚举。
Camera_Status Camera_Status 相机状态的枚举。
Camera_SceneMode Camera_SceneMode 相机模式的枚举。
Camera_Position Camera_Position 相机位置的枚举。
Camera_Type Camera_Type 相机类型的枚举。
Camera_Connection Camera_Connection 相机连接类型的枚举。
OH_Camera_SensorColorFilterArrangement OH_Camera_SensorColorFilterArrangement 传感器滤色阵列排列方式。
Camera_Format Camera_Format 相机格式类型的枚举。
Camera_FlashMode Camera_FlashMode 闪光模式的枚举。
OH_Camera_FlashState OH_Camera_FlashState 闪光灯状态枚举。
Camera_ExposureMode Camera_ExposureMode 曝光模式的枚举。
OH_Camera_ExposureMeteringMode OH_Camera_ExposureMeteringMode 曝光测光模式枚举。
Camera_FocusMode Camera_FocusMode 聚焦模式的枚举。
Camera_FocusState Camera_FocusState 焦点状态的枚举。
Camera_VideoStabilizationMode Camera_VideoStabilizationMode 录像防抖模式的枚举。
Camera_ImageRotation Camera_ImageRotation 图像旋转角度的枚举。
Camera_QualityLevel Camera_QualityLevel 图像质量等级的枚举。
Camera_MetadataObjectType Camera_MetadataObjectType 元数据对象类型的枚举。
Camera_TorchMode Camera_TorchMode 手电筒模式的枚举。
Camera_SmoothZoomMode Camera_SmoothZoomMode 平滑变焦模式的枚举。
Camera_SystemPressureLevel Camera_SystemPressureLevel 系统压力等级的枚举。
Camera_PreconfigType Camera_PreconfigType 预配置照片分辨率的枚举。
Camera_PreconfigRatio Camera_PreconfigRatio 预配置照片比例的枚举。
Camera_HostDeviceType Camera_HostDeviceType 远程设备类型枚举。
Camera_FoldStatus Camera_FoldStatus 折叠状态枚举。
Camera_QualityPrioritization Camera_QualityPrioritization 录像质量优先级的枚举。
Camera_ConcurrentType Camera_ConcurrentType 相机并发状态的枚举。
Camera_WhiteBalanceMode Camera_WhiteBalanceMode 白平衡模式枚举。
Camera_ControlCenterEffectType Camera_ControlCenterEffectType 控制器效果类型枚举。
Camera_PhotoQualityPrioritization Camera_PhotoQualityPrioritization 拍照画质优先策略枚举。
OH_Camera_OISMode OH_Camera_OISMode 光学防抖（Optical Image Stabilization）模式枚举。
OH_Camera_OISAxes OH_Camera_OISAxes 光学防抖（OIS）轴枚举。
OH_Camera_ExposureState OH_Camera_ExposureState 枚举相机曝光状态。
OH_Camera_MetadataObjectEmotion OH_Camera_MetadataObjectEmotion 元数据对象情绪类型枚举。
OH_Camera_AutomotiveCameraPosition OH_Camera_AutomotiveCameraPosition Car设备摄像头位置的枚举。
OH_Camera_AuxiliaryPhotoType OH_Camera_AuxiliaryPhotoType 辅助图类型的枚举。在用于拍摄皮肤健康评估的辅助图时，使用该枚举类型来指定检测目标。

[h2]函数

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

枚举类型说明

[h2]Camera_ErrorCode

enum Camera_ErrorCode

描述

相机错误代码的枚举。

起始版本： 11

枚举项 描述
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

与当前配置存在冲突。

起始版本： 12
CAMERA_ERROR_OPTIONAL_PROPERTY_NOT_EXIST = 7400113

可选属性不存在。

起始版本： 26.0.0
CAMERA_SERVICE_FATAL_ERROR = 7400201

相机服务异常。

比如没有相机权限、相机服务重启、跨进程调用异常等。
CAMERA_ERROR_CAPABILITY_NOT_SUPPORTED = 7400114

表示设备当前不支持该能力。

起始版本： 26.0.0
CAMERA_ERROR_UNSUPPORTED_MULTI_CAMERA_COMBINATION = 7400115

不支持的多摄组合。当因为硬件限制或驱动约束而尝试使用不支持的多摄组合时会返回此错误。请考虑使用其他相机组合，或查看设备支持的相机配置。

起始版本： 26.0.1
CAMERA_ERROR_PARAM_OUT_OF_RANGE = 7400116

参数超出范围。当参数值（如ISO、曝光时间或对焦距离）超出有效范围时会返回此错误。请确保取值在当前相机配置支持的范围内。

起始版本： 26.0.1

[h2]Camera_Status

enum Camera_Status

描述

相机状态的枚举。

起始版本： 11

枚举项 描述
CAMERA_STATUS_APPEAR = 0 显示状态。
CAMERA_STATUS_DISAPPEAR = 1 消失状态。
CAMERA_STATUS_AVAILABLE = 2 可用状态。
CAMERA_STATUS_UNAVAILABLE = 3 不可用状态。

[h2]Camera_SceneMode

enum Camera_SceneMode

描述

相机模式的枚举。

起始版本： 12

枚举项 描述
NORMAL_PHOTO = 1 普通相机模式。
NORMAL_VIDEO = 2 普通视频模式。
SECURE_PHOTO = 12 安全相机模式，主要为银行等有活体检测等安全诉求的应用提供。安全相机的使用需要加密算法框架及可信应用服务，详情请参见Device Certificate Kit简介。

[h2]Camera_Position

enum Camera_Position

描述

相机位置的枚举。

起始版本： 11

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

[h2]Camera_Type

enum Camera_Type

描述

相机类型的枚举。

起始版本： 11

枚举项 描述
CAMERA_TYPE_DEFAULT = 0 默认相机类型。
CAMERA_TYPE_WIDE_ANGLE = 1 广角相机。
CAMERA_TYPE_ULTRA_WIDE = 2 超广角相机。
CAMERA_TYPE_TELEPHOTO = 3 长焦相机。
CAMERA_TYPE_TRUE_DEPTH = 4 景深相机。

[h2]Camera_Connection

enum Camera_Connection

描述

相机连接类型的枚举。

起始版本： 11

枚举项 描述
CAMERA_CONNECTION_BUILT_IN = 0 内置相机。
CAMERA_CONNECTION_USB_PLUGIN = 1 使用USB连接的相机。
CAMERA_CONNECTION_REMOTE = 2 远程相机。

[h2]OH_Camera_SensorColorFilterArrangement

enum OH_Camera_SensorColorFilterArrangement

描述

传感器滤色阵列排列方式。

起始版本： 24

枚举项 描述
OH_CAMERA_SENSOR_CFA_BGGR = 0

BGGR（Blue-Green-Green-Red）滤色阵列排列。

起始版本： 24
OH_CAMERA_SENSOR_CFA_GBRG = 1

GBRG（Green-Blue-Red-Green）滤色阵列排列。

起始版本： 24
OH_CAMERA_SENSOR_CFA_GRBG = 2

GRBG（Green-Red-Blue-Green）滤色阵列排列。

起始版本： 24
OH_CAMERA_SENSOR_CFA_RGGB = 3

RGGB（Red-Green-Green-Blue）滤色阵列排列。

起始版本： 24

[h2]Camera_Format

enum Camera_Format

描述

相机格式类型的枚举。

起始版本： 11

枚举项 描述
CAMERA_FORMAT_RGBA_8888 = 3 RGBA 8888格式。
CAMERA_FORMAT_DNG = 4

DNG格式。

起始版本： 24
CAMERA_FORMAT_DNG_XDRAW = 5

增强型DNG格式。

起始版本： 26.0.0
CAMERA_FORMAT_YUV_420_SP = 1003 YUV 420格式。
CAMERA_FORMAT_JPEG = 2000 JPEG格式。
CAMERA_FORMAT_YCBCR_P010 = 2001

YCBCR P010 格式。

起始版本： 12
CAMERA_FORMAT_YCRCB_P010 = 2002

YCRCB P010 格式。

起始版本： 12
CAMERA_FORMAT_HEIC = 2003

HEIC格式。

起始版本： 23

[h2]Camera_FlashMode

enum Camera_FlashMode

描述

闪光模式的枚举。

起始版本： 11

枚举项 描述
FLASH_MODE_CLOSE = 0 关闭模式。
FLASH_MODE_OPEN = 1 打开模式。
FLASH_MODE_AUTO = 2 自动模式。
FLASH_MODE_ALWAYS_OPEN = 3 始终打开模式。

[h2]OH_Camera_FlashState

enum OH_Camera_FlashState

描述

闪光灯状态枚举。

起始版本： 24

枚举项 描述
OH_CAMERA_FLASH_STATE_UNAVAILABLE = 0

闪光灯为不可用状态，为默认值。

起始版本： 24
OH_CAMERA_FLASH_STATE_READY = 1

闪光灯为可用状态。

起始版本： 24
OH_CAMERA_FLASH_STATE_FLASHING = 2

闪光灯已经被打开。

起始版本： 24

[h2]Camera_ExposureMode

enum Camera_ExposureMode

描述

曝光模式的枚举。

起始版本： 11

枚举项 描述
EXPOSURE_MODE_UNSPECIFIED = -1

曝光模式未指定。

起始版本： 24
EXPOSURE_MODE_LOCKED = 0

锁定曝光模式。 不支持曝光区域中心点设置。

设置该模式后，每次拍照时曝光都会默认锁定。
EXPOSURE_MODE_AUTO = 1

自动曝光模式。支持曝光区域中心点设置，可以使用OH_CaptureSession_SetMeteringPoint接口设置曝光区域中心点。

设置该模式后，仅设置后的首次拍照生效。
EXPOSURE_MODE_CONTINUOUS_AUTO = 2

连续自动曝光。

设置该模式后，拍照系统会根据每次的环境变化自动调整曝光。
EXPOSURE_MODE_MANUAL = 3

手动曝光模式。可以使用OH_CaptureSession_SetExposureDuration接口设置曝光时长。

起始版本： 24

[h2]OH_Camera_ExposureMeteringMode

enum OH_Camera_ExposureMeteringMode

描述

曝光测光模式枚举。

起始版本： 24

枚举项 描述
OH_CAMERA_EXPOSURE_METERING_MODE_MATRIX = 0

矩阵测光模式。对整个画面测光，适用于自然风景拍摄。

起始版本： 24
OH_CAMERA_EXPOSURE_METERING_MODE_CENTER = 1

中央测光模式。对画面中心区域测光，适用于人像拍摄。

起始版本： 24
OH_CAMERA_EXPOSURE_METERING_MODE_SPOT = 2

点测光模式。对指定微小区域测光，适用于拍摄主体细节（如人物眼睛）。

起始版本： 24

[h2]Camera_FocusMode

enum Camera_FocusMode

描述

聚焦模式的枚举。

起始版本： 11

枚举项 描述
FOCUS_MODE_MANUAL = 0 手动模式。
FOCUS_MODE_CONTINUOUS_AUTO = 1 连续自动模式。
FOCUS_MODE_AUTO = 2 自动模式。
FOCUS_MODE_LOCKED = 3 锁定模式。

[h2]Camera_FocusState

enum Camera_FocusState

描述

焦点状态的枚举。

起始版本： 11

枚举项 描述
FOCUS_STATE_SCAN = 0 扫描状态。
FOCUS_STATE_FOCUSED = 1 聚焦状态。
FOCUS_STATE_UNFOCUSED = 2 非聚焦状态。

[h2]Camera_VideoStabilizationMode

enum Camera_VideoStabilizationMode

描述

录像防抖模式的枚举。

起始版本： 11

枚举项 描述
STABILIZATION_MODE_OFF = 0 关闭录像防抖。
STABILIZATION_MODE_LOW = 1 LOW模式，提供基本的防抖效果。
STABILIZATION_MODE_MIDDLE = 2 MIDDLE模式，表示通过算法可以获得比LOW模式更好的效果。
STABILIZATION_MODE_HIGH = 3 HIGH模式，表示通过算法可以获得比MIDDLE模式更好的效果。
STABILIZATION_MODE_AUTO = 4 自动选择模式，HDF相机可用。

[h2]Camera_ImageRotation

enum Camera_ImageRotation

描述

图像旋转角度的枚举。

起始版本： 11

枚举项 描述
IAMGE_ROTATION_0 = 0

捕获图像旋转0度。

从API version 23开始，推荐使用新枚举值CAMERA_IMAGE_ROTATION_0。
CAMERA_IMAGE_ROTATION_0 = 0

捕获图像旋转0度。

起始版本： 23
IAMGE_ROTATION_90 = 90

捕获图像旋转90度。

从API version 23开始，推荐使用新枚举值CAMERA_IMAGE_ROTATION_90。
CAMERA_IMAGE_ROTATION_90 = 90

捕获图像旋转90度。

起始版本： 23
IAMGE_ROTATION_180 = 180

捕获图像旋转180度。

从API version 23开始，推荐使用新枚举值CAMERA_IMAGE_ROTATION_180。
CAMERA_IMAGE_ROTATION_180 = 180

捕获图像旋转180度。

起始版本： 23
IAMGE_ROTATION_270 = 270

捕获图像旋转270度。

从API version 23开始，推荐使用新枚举值CAMERA_IMAGE_ROTATION_270。
CAMERA_IMAGE_ROTATION_270 = 270

捕获图像旋转270度。

起始版本： 23

[h2]Camera_QualityLevel

enum Camera_QualityLevel

描述

图像质量等级的枚举。

起始版本： 11

枚举项 描述
QUALITY_LEVEL_HIGH = 0 高图像质量。
QUALITY_LEVEL_MEDIUM = 1 中等图像质量。
QUALITY_LEVEL_LOW = 2 低图像质量。

[h2]Camera_MetadataObjectType

enum Camera_MetadataObjectType

描述

元数据对象类型的枚举。

起始版本： 11

枚举项 描述
FACE_DETECTION = 0

元数据的对象类型，用于人脸检测。

从API version 23开始，推荐使用新枚举值CAMERA_METADATA_OBJECT_TYPE_FACE_DETECTION。
CAMERA_METADATA_OBJECT_TYPE_FACE_DETECTION = 0

元数据的对象类型，用于人脸检测。

起始版本： 23
CAMERA_METADATA_OBJECT_TYPE_HUMAN_BODY = 1

元数据的对象类型，用于人体检测。

起始版本： 23
CAMERA_METADATA_OBJECT_TYPE_CAT_FACE = 2

元数据的对象类型，用于猫脸检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_CAT_BODY = 3

元数据的对象类型，用于猫体检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_DOG_FACE = 4

元数据的对象类型，用于狗脸检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_DOG_BODY = 5

元数据的对象类型，用于狗体检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_SALIENT_DETECTION = 6

元数据的对象类型，用于显著性物体检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_BAR_CODE_DETECTION = 7

元数据的对象类型，用于二维码检测。

起始版本： 26.0.0
CAMERA_METADATA_OBJECT_TYPE_BASIC_FACE_DETECTION = 8

元数据的对象类型，用于基础人脸检测。

起始版本： 26.0.0

[h2]Camera_TorchMode

enum Camera_TorchMode

描述

手电筒模式的枚举。

起始版本： 12

枚举项 描述
OFF = 0

设备手电筒常关。

从API version 23开始，推荐使用新枚举值CAMERA_TORCH_MODE_OFF。
CAMERA_TORCH_MODE_OFF = 0

设备手电筒常关。

起始版本： 23
ON = 1

设备手电筒常开。

从API version 23开始，推荐使用新枚举值CAMERA_TORCH_MODE_ON。
CAMERA_TORCH_MODE_ON = 1

设备手电筒常开。

起始版本： 23
AUTO = 2

设备手电筒自动模式，将根据环境光照水平打开手电筒。

从API version 23开始，推荐使用新枚举值CAMERA_TORCH_MODE_AUTO。
CAMERA_TORCH_MODE_AUTO = 2

设备手电筒自动模式，将根据环境光照水平打开手电筒。

起始版本： 23

[h2]Camera_SmoothZoomMode

enum Camera_SmoothZoomMode

描述

平滑变焦模式的枚举。

起始版本： 12

枚举项 描述
NORMAL = 0

贝塞尔曲线模式。

从API version 23开始，推荐使用新枚举值CAMERA_SMOOTH_ZOOM_MODE_NORMAL。
CAMERA_SMOOTH_ZOOM_MODE_NORMAL = 0

贝塞尔曲线模式。

起始版本： 23

[h2]Camera_SystemPressureLevel

enum Camera_SystemPressureLevel

描述

系统压力等级的枚举。

起始版本： 20

枚举项 描述
SYSTEM_PRESSURE_NORMAL = 0 系统压力正常。
SYSTEM_PRESSURE_MILD = 1 系统压力升高，但是系统不会主动管控。
SYSTEM_PRESSURE_SEVERE = 2 系统压力可能对图像总质量、性能产生影响。
SYSTEM_PRESSURE_CRITICAL = 3 系统图像质量、性能产生显著影响。
SYSTEM_PRESSURE_SHUTDOWN = 4 系统压力过高，停止工作。

[h2]Camera_PreconfigType

enum Camera_PreconfigType

描述

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

起始版本： 12

枚举项 描述
PRECONFIG_720P = 0 预配置照片分辨率为720P。
PRECONFIG_1080P = 1 预配置照片分辨率为1080P。
PRECONFIG_4K = 2 预配置照片分辨率为4K。
PRECONFIG_HIGH_QUALITY = 3 预配置照片为高质量。
PRECONFIG_HIGH_QUALITY_PHOTOSESSION_BT2020 = 4

预配置支持预览高动态范围显示和HDR动图拍摄。

起始版本： 23

[h2]Camera_PreconfigRatio

enum Camera_PreconfigRatio

描述

预配置照片比例的枚举。

起始版本： 12

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

[h2]Camera_HostDeviceType

enum Camera_HostDeviceType

描述

远程设备类型枚举。

起始版本： 15

枚举项 描述
HOST_DEVICE_TYPE_UNKNOWN_TYPE = 0 未知设备类型。
HOST_DEVICE_TYPE_PHONE = 0x0E 手机设备。
HOST_DEVICE_TYPE_TABLET = 0x11 平板设备。
HOST_DEVICE_TYPE_GLASSES = 0xA31

眼镜设备。

起始版本： 26.0.1

[h2]Camera_FoldStatus

enum Camera_FoldStatus

描述

折叠状态枚举。

起始版本： 13

枚举项 描述
NON_FOLDABLE = 0

不可折叠状态。

从API version 23开始，推荐使用新枚举值CAMERA_FOLD_STATUS_NON_FOLDABLE。
CAMERA_FOLD_STATUS_NON_FOLDABLE = 0

不可折叠状态。

起始版本： 23
EXPANDED = 1

展开状态。

从API version 23开始，推荐使用新枚举值CAMERA_FOLD_STATUS_EXPANDED。
CAMERA_FOLD_STATUS_EXPANDED = 1

展开状态。

起始版本： 23
FOLDED = 2

折叠状态。

从API version 23开始，推荐使用新枚举值CAMERA_FOLD_STATUS_FOLDED。
CAMERA_FOLD_STATUS_FOLDED = 2

折叠状态。

起始版本： 23

[h2]Camera_QualityPrioritization

enum Camera_QualityPrioritization

描述

录像质量优先级的枚举。

起始版本： 14

枚举项 描述
HIGH_QUALITY = 0 高录像质量。
POWER_BALANCE = 1 功耗平衡录像质量。

[h2]Camera_ConcurrentType

enum Camera_ConcurrentType

描述

相机并发状态的枚举。

起始版本： 18

枚举项 描述
CAMERA_CONCURRENT_TYPE_LIMITED_CAPABILITY = 0 相机限制并发。
CAMERA_CONCURRENT_TYPE_FULL_CAPABILITY = 1 相机全量并发。

[h2]Camera_WhiteBalanceMode

enum Camera_WhiteBalanceMode

描述

白平衡模式枚举。

起始版本： 20

枚举项 描述
CAMERA_WHITE_BALANCE_MODE_AUTO = 0 白平衡模式：自动。
CAMERA_WHITE_BALANCE_MODE_CLOUDY = 1 白平衡模式：阴天。
CAMERA_WHITE_BALANCE_MODE_INCANDESCENT = 2 白平衡模式：白炽灯。
CAMERA_WHITE_BALANCE_MODE_FLUORESCENT = 3 白平衡模式：荧光。
CAMERA_WHITE_BALANCE_MODE_DAYLIGHT = 4 白平衡模式：晴天。
CAMERA_WHITE_BALANCE_MODE_MANUAL = 5 白平衡模式：手动。
CAMERA_WHITE_BALANCE_MODE_LOCKED = 6 白平衡模式：锁定。

[h2]Camera_ControlCenterEffectType

enum Camera_ControlCenterEffectType

描述

控制器效果类型枚举。

起始版本： 20

枚举项 描述
CONTROL_CENTER_EFFECT_TYPE_BEAUTY = 0 控制器效果类型：美颜。
CONTROL_CENTER_EFFECT_TYPE_PORTRAIT = 1 控制器效果类型：人像虚化。
CONTROL_CENTER_EFFECT_TYPE_AUTO_FRAMING = 2

控制器效果类型：自动对焦。

起始版本： 24
CONTROL_CENTER_EFFECT_TYPE_COLOR_EFFECT = 3

控制器效果类型：XMAGE风格。

起始版本： 26.0.0

[h2]Camera_PhotoQualityPrioritization

enum Camera_PhotoQualityPrioritization

描述

拍照画质优先策略枚举。

起始版本： 21

枚举项 描述
CAMERA_PHOTO_QUALITY_PRIORITIZATION_HIGH_QUALITY = 0 画质优先，拍照需要较长的时间，以输出高画质的图片。
CAMERA_PHOTO_QUALITY_PRIORITIZATION_SPEED = 1 性能优先，会降低画质来提升拍照的速度。

[h2]OH_Camera_OISMode

enum OH_Camera_OISMode

描述

光学防抖（Optical Image Stabilization）模式枚举。

起始版本： 24

枚举项 描述
OH_CAMERA_OIS_MODE_OFF = 0 关闭光学防抖模式。
OH_CAMERA_OIS_MODE_AUTO = 1 自动光学防抖模式。
OH_CAMERA_OIS_MODE_CUSTOM = 2 手动光学防抖模式。

[h2]OH_Camera_OISAxes

enum OH_Camera_OISAxes

描述

光学防抖（OIS）轴枚举。

起始版本： 24

枚举项 描述
OH_CAMERA_OIS_AXES_PITCH = 0 俯仰轴：控制相机机身上下旋转，即机身围绕与镜头水平方向的轴旋转。
OH_CAMERA_OIS_AXES_YAW = 1 偏航轴：控制相机机身左右旋转，即机身围绕与镜头垂直方向的轴旋转。

[h2]OH_Camera_ExposureState

enum OH_Camera_ExposureState

描述

枚举相机曝光状态。

起始版本： 26.0.0

枚举项 描述
OH_CAMERA_EXPOSURE_STATE_SCAN = 0

表示曝光处于扫描状态。

起始版本： 26.0.0
OH_CAMERA_EXPOSURE_STATE_CONVERGED = 1

表示曝光已经收敛。

起始版本： 26.0.0

[h2]OH_Camera_MetadataObjectEmotion

enum OH_Camera_MetadataObjectEmotion

描述

元数据对象情绪类型枚举。

起始版本： 26.0.0

枚举项 描述
OH_CAMERA_METADATA_OBJECT_EMOTION_NEUTRAL = 0

平静。

起始版本： 26.0.0
OH_CAMERA_METADATA_OBJECT_EMOTION_SADNESS = 1

悲伤。

起始版本： 26.0.0
OH_CAMERA_METADATA_OBJECT_EMOTION_SMILE = 2

微笑。

起始版本： 26.0.0
OH_CAMERA_METADATA_OBJECT_EMOTION_SURPRISE = 3

惊讶。

起始版本： 26.0.0

[h2]OH_Camera_AutomotiveCameraPosition

enum OH_Camera_AutomotiveCameraPosition

描述

Car设备摄像头位置的枚举。

起始版本： 26.0.0

枚举项 描述
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_EXTERIOR_OTHER = 0

Car设备外部其他位置摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_EXTERIOR_FRONT = 1

Car设备外部前侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_EXTERIOR_REAR = 2

Car设备外部后侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_EXTERIOR_LEFT = 3

Car设备外部左侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_EXTERIOR_RIGHT = 4

Car设备外部右侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_OTHER = 5

Car设备内部其他位置摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_1_LEFT = 6

Car设备内部第一排左侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_1_CENTER = 7

Car设备内部第一排中央摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_1_RIGHT = 8

Car设备内部第一排右侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_2_LEFT = 9

Car设备内部第二排左侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_2_CENTER = 10

Car设备内部第二排中央摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_2_RIGHT = 11

Car设备内部第二排右侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_3_LEFT = 12

Car设备内部第三排左侧摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_3_CENTER = 13

Car设备内部第三排中央摄像头。

起始版本： 26.0.0
OH_CAMERA_AUTOMOTIVE_CAMERA_POSITION_INTERIOR_ROW_3_RIGHT = 14

Car设备内部第三排右侧摄像头。

起始版本： 26.0.0

[h2]OH_Camera_AuxiliaryPhotoType

enum OH_Camera_AuxiliaryPhotoType

描述

辅助图类型的枚举。在用于拍摄皮肤健康评估的辅助图时，使用该枚举类型来指定检测目标。

起始版本： 26.0.1

枚举项 描述
OH_CAMERA_AUXILIARY_PHOTO_TYPE_OXYGEN = 0

血氧图。

起始版本： 26.0.1
OH_CAMERA_AUXILIARY_PHOTO_TYPE_PIGMENTATION = 1

色斑图。

起始版本： 26.0.1

函数说明

[h2]OH_Camera_GetCameraManager()

Camera_ErrorCode OH_Camera_GetCameraManager(Camera_Manager** cameraManager)

描述

创建CameraManager实例。

起始版本： 11

参数：

参数项 描述
Camera_Manager** cameraManager 如果方法调用成功，将创建Camera_Manager实例。

返回：

类型 说明
Camera_ErrorCode

CAMERA_OK：方法调用成功。

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

CAMERA_SERVICE_FATAL_ERROR：相机服务异常。

[h2]OH_Camera_DeleteCameraManager()

Camera_ErrorCode OH_Camera_DeleteCameraManager(Camera_Manager* cameraManager)

描述

删除CameraManager实例。

起始版本： 11

参数：

参数项 描述
Camera_Manager* cameraManager 要删除的Camera_Manager实例。

返回：

类型 说明
Camera_ErrorCode

CAMERA_OK：方法调用成功。

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

CAMERA_SERVICE_FATAL_ERROR：相机服务异常。