1# Camera (V1_3) 2 3 4## 概述 5 6Camera模块接口定义。 7 8Camera模块涉及相机设备的操作、流的操作、离线流的操作和各种回调等。 9 10**起始版本：** 5.0 11 12 13## 汇总 14 15 16### 文件 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [ICameraDevice.idl](_i_camera_device_8idl_v13.md) | Camera设备操作接口。 | 21| [ICameraHost.idl](_i_camera_host_8idl_v13.md) | Camera服务的管理类，对上层提供HDI接口。 | 22| [IImageProcessService.idl](_i_image_process_service_8idl_v13.md) | 声明用于图像处理服务的API。 | 23| [IStreamOperator.idl](_i_stream_operator_8idl_v13.md) | 流的操作接口。 | 24| [IStreamOperatorCallback.idl](_i_stream_operator_callback_8idl_v13.md) | [IStreamOperator](interface_i_stream_operator_v13.md)相关的回调，这些回调均由调用者实现。 | 25| [IVideoProcessCallback.idl](_i_video_process_callback_8idl_v13.md) | 声明视频流进程的回调。 | 26| [IVideoProcessService.idl](_i_video_process_service_8idl_v13.md) | 声明用于视频处理服务的API。 | 27| [IVideoProcessSession.idl](_i_video_process_session_8idl_v13.md) | 声明用于视频处理会话的API。 | 28| [Types.idl](_types_8idl_v13.md) | Camera模块HDI接口使用的数据类型。 | 29 30 31### 结构体 32 33| 名称 | 描述 | 34| -------- | -------- | 35| interface [ICameraDevice](interface_i_camera_device_v13.md) | 定义Camera设备基本的操作。 | 36| interface [ICameraHost](interface_i_camera_host_v13.md) | 定义Camera设备功能操作。 | 37| interface [IImageProcessCallback](interface_i_image_process_callback_v13.md) | 定义声明图像处理回调。 | 38| interface [IImageProcessService](interface_i_image_process_service_v13.md) | 声明图像处理进程服务。 | 39| interface [IStreamOperator](interface_i_stream_operator_v13.md) | 定义Camera设备流操作。 | 40| interface [IStreamOperatorCallback](interface_i_stream_operator_callback_v13.md) | 定义Camera设备流回调操作。 | 41| interface [IVideoProcessCallback](interface_i_video_process_callback_v13.md) | 定义声明图像处理回调。 | 42| interface [IVideoProcessService](interface_i_video_process_service_v13.md) | 声明视频处理进程服务。 | 43| interface [IVideoProcessSession](interface_i_video_process_session_v13.md) | 图像处理会话进程。 | 44| struct [CameraDeviceResourceCost](_camera_device_resource_cost_v13.md) | 相机设备资源开销，用于**ICameraDevice::[GetResourceCost()](interface_i_camera_host_v13.md#getresourcecost)**。 | 45| struct [StreamDescription](_stream_description_v13.md) | 流描述信息，使用于[IVideoProcessSession::Prepare](interface_i_video_process_session_v13.md#prepare)。 | 46| struct [CaptureEndedInfoExt](_capture_ended_info_ext_v13.md) | 拍照结束信息，使用于[IStreamOperatorCallback::OnCaptureEndedExt](interface_i_stream_operator_callback_v13.md#oncaptureendedext)。 | 47| struct [ImageBufferInfoExt](_image_buffer_info_ext_v13.md) | 图片流信息，使用于[IImageProcessCallback::OnProcessDoneExt](interface_i_image_process_callback_v13.md#onprocessdoneext)。 | 48 49 50### 枚举 51 52| 名称 | 描述 | 53| -------- | -------- | 54| [OperationMode](#operationmode) : ohos.hdi.camera.v1_2.OperationMode_V1_2 {<br/>PROFESSIONAL_V1_3 = PROFESSIONAL, PROFESSIONAL_PHOTO = 11, PROFESSIONAL_VIDEO = 12, HIGH_FRAME_RATE = 13,<br/>HIGH_RESOLUTION_PHOTO = 14, SECURE = 15, QUICK_SHOT_PHOTO = 16, LIGHT_PAINTING = 17, PANORAMA_PHOTO = 18, TIMELAPSE_PHOTO = 19,<br/>APERTURE_VIDEO = 20, FLUORESCENCE_PHOTO = 21, SUN_BLOCK = 22} | 流使用模式。 | 55| [ExtendedStreamInfoType](#extendedstreaminfotype) : ohos.hdi.camera.v1_2.ExtendedStreamInfoType_V1_2 {<br/>EXTENDED_STREAM_INFO_RAW = 2, EXTENDED_STREAM_INFO_DEPTH = 3, EXTENDED_STREAM_INFO_META = 4, EXTENDED_STREAM_INFO_SECURE = 5,<br/>EXTENDED_STREAM_INFO_MAKER_INFO = 6, EXTENDED_STREAM_INFO_EXIF = 7, EXTENDED_STREAM_INFO_GAINMAP = 8, EXTENDED_STREAM_INFO_UNREFOCUS = 9,<br/>EXTENDED_STREAM_INFO_LINEAR = 10, EXTENDED_STREAM_INFO_FRAGMENT =11, EXTENDED_STREAM_INFO_UV = 12} | 扩展流信息的类型。 | 56| [StreamType](#streamtype) {<br/>STREAM_TYPE_PREVIEW = 0, STREAM_TYPE_VIDEO = 1, STREAM_TYPE_STILL_CAPTURE = 2, STREAM_TYPE_POST_VIEW = 3, STREAM_TYPE_ANALYZE = 4,<br/>STREAM_TYPE_CUSTOM = 5, STREAM_TYPE_DEPTH = 6} | 流类型。 | 57| [ExecutionMode](#executionmode) : ohos.hdi.camera.v1_2.ExecutionMode { DEFAULT = 3 } | 执行模式的类型。 | 58| [ErrorType](#errortype) : ohos.hdi.camera.v1_0.ErrorType { SENSOR_DATA_ERROR = 5 } | 设备错误类型，用于设备错误回调**[OnError()](interface_i_video_process_callback_v13.md#onerror)**。 | 59| [MediaStreamType](#mediastreamtype) { MEDIA_STREAM_TYPE_VIDEO = 0,<br/>MEDIA_STREAM_TYPE_METADATA = 1, MEDIA_STREAM_TYPE_MAKER = 2 } | 相机媒体流类型。 | 60| [EncodeType](#encodetype) : ohos.hdi.camera.v1_0.EncodeType { ENCODE_TYPE_HEIC = 4 } | 流数据的编码类型。 | 61| [StreamError](#streamerror) : ohos.hdi.camera.v1_0.StreamError { HIGH_TEMPERATURE_ERROR = 2 } | 流错误类型，用于流错误类型**[CaptureErrorInfo](_capture_ended_info_v10.md)**。 | 62 63 64## 枚举类型说明 65 66 67### EncodeType 68 69``` 70enum EncodeType : ohos.hdi.camera.v1_0.EncodeType 71``` 72 73**描述** 74 75流数据的编码类型。 76 77**起始版本：** 5.0 78 79| 枚举值 | 描述 | 80| -------- | -------- | 81| ENCODE_TYPE_HEIC | HEIC编码格式。 | 82 83 84### ErrorType 85 86``` 87enum ErrorType : ohos.hdi.camera.v1_0.ErrorType 88``` 89 90**描述** 91 92设备错误类型，用于设备错误回调**[OnError()](interface_i_video_process_callback_v13.md#onerror)**。 93 94**起始版本：** 3.2 95 96| 枚举值 | 描述 | 97| -------- | -------- | 98| SENSOR_DATA_ERROR | 传感器数据错误。<br/>**起始版本：**5.0 | 99 100 101### ExecutionMode 102 103``` 104enum ExecutionMode : ohos.hdi.camera.v1_2.ExecutionMode 105``` 106 107**描述** 108 109执行模式的类型。 110 111**起始版本：** 4.1 112 113| 枚举值 | 描述 | 114| -------- | -------- | 115| DEFAULT | 默认模式。 | 116 117 118### ExtendedStreamInfoType 119 120``` 121enum ExtendedStreamInfoType : ohos.hdi.camera.v1_2.ExtendedStreamInfoType_V1_2 122``` 123 124**描述** 125 126扩展流信息的类型。 127 128**起始版本：** 4.0 129 130| 枚举值 | 描述 | 131| -------- | -------- | 132| EXTENDED_STREAM_INFO_RAW | raw图的扩展流信息。<br/>**起始版本：**5.0 | 133| EXTENDED_STREAM_INFO_DEPTH | 深度流的扩展流信息。<br/>**起始版本：**5.0 | 134| EXTENDED_STREAM_INFO_META | meta流的扩展流信息。<br/>**起始版本：**5.0 | 135| EXTENDED_STREAM_INFO_SECURE | 安全流的扩展流信息。<br/>**起始版本：**5.0 | 136| EXTENDED_STREAM_INFO_MAKER_INFO | 维测流的扩展流信息。<br/>**起始版本：**5.0 | 137| EXTENDED_STREAM_INFO_EXIF | exif流的扩展流信息。<br/>**起始版本：**5.0 | 138| EXTENDED_STREAM_INFO_GAINMAP | 高显图的扩展流信息。<br/>**起始版本：**5.0 | 139| EXTENDED_STREAM_INFO_UNREFOCUS | unrefocus流的扩展流信息。<br/>**起始版本：**5.0 | 140| EXTENDED_STREAM_INFO_LINEAR | 线型图的的扩展流信息。<br/>**起始版本：**5.0 | 141| EXTENDED_STREAM_INFO_FRAGMENT | 水平裁切图的扩展流信息。<br/>**起始版本：**5.0 | 142| EXTENDED_STREAM_INFO_UV | uv附图的扩展流信息。<br/>**起始版本：**5.0 | 143 144 145### MediaStreamType 146 147``` 148enum MediaStreamType 149``` 150 151**描述** 152 153相机媒体流类型。 154 155**起始版本：** 5.0 156 157| 枚举值 | 描述 | 158| -------- | -------- | 159| MEDIA_STREAM_TYPE_VIDEO | 视频媒体流。<br/>**起始版本：**5.0 | 160| MEDIA_STREAM_TYPE_METADATA | metadata媒体流。<br/>**起始版本：**5.0 | 161| MEDIA_STREAM_TYPE_MAKER | 维测媒体流。<br/>**起始版本：**5.0 | 162 163 164### OperationMode 165 166``` 167enum OperationMode : ohos.hdi.camera.v1_2.OperationMode_V1_2 168``` 169 170**描述** 171 172流使用模式。 173 174**起始版本：** 3.2 175 176| 枚举值 | 描述 | 177| -------- | -------- | 178| PROFESSIONAL_V1_3 | 专业模式，专用于专业拍照场景。<br/>**起始版本：**4.1 | 179| PROFESSIONAL_PHOTO | 专业拍照模式，专用于专业拍照场景。<br/>**起始版本：**5.0 | 180| PROFESSIONAL_VIDEO | 专业录像模式，专用于专业录像场景。<br/>**起始版本：**5.0 | 181| HIGH_FRAME_RATE | 慢动作模式，专门用于视频录制慢动作。<br/>**起始版本：**5.0 | 182| HIGH_RESOLUTION_PHOTO | 高分辨率照片模式，专门用于捕捉记录高像素。<br/>**起始版本：**5.0 | 183| SECURE | 安全模式，专用于安全模式。<br/>**起始版本：**5.0 | 184| QUICK_SHOT_PHOTO | 闪拍模式，专为快速拍照模式设计。<br/>**起始版本：**5.0 | 185| LIGHT_PAINTING | 流光快门模式，专用于光绘模式。<br/>**起始版本：**5.0 | 186| PANORAMA_PHOTO | 全景模式，专用于全景模式。<br/>**起始版本：**5.0 | 187| TIMELAPSE_PHOTO | 延时摄影模式，专用于延时摄影模式。<br/>**起始版本：**5.0 | 188| APERTURE_VIDEO | 大光圈模式，专用于大光圈模式。<br/>**起始版本：**5.0 | 189| FLUORESCENCE_PHOTO | 荧光拍照模式，专用于荧光拍照模式。<br/>**起始版本：**5.0 | 190| SUN_BLOCK | 防晒检测模式，专用于防晒检测模式。<br/>**起始版本：**5.0 | 191 192 193### StreamError 194 195``` 196enum StreamError : ohos.hdi.camera.v1_0.StreamError 197``` 198 199**描述** 200 201流错误类型，用于流错误类型**[CaptureErrorInfo](_capture_error_info_v10.md)**。 202 203**起始版本：** 3.2 204 205| 枚举值 | 描述 | 206| -------- | -------- | 207| HIGH_TEMPERATURE_ERROR | 当传感器温度高于阈值，cameraHal将会停止上报画中画流并且通过OnCaptureError回调上报高温错误码。<br/>**起始版本：**5.0 | 208 209 210### StreamType 211 212``` 213enum StreamType 214``` 215 216**描述** 217 218流类型。 219 220**起始版本：** 5.0 221 222| 枚举值 | 描述 | 223| -------- | -------- | 224| STREAM_TYPE_PREVIEW | 流数据用于显示，即预览流。 | 225| STREAM_TYPE_VIDEO | 数据用于编码生成录像，即录像流。 | 226| STREAM_TYPE_STILL_CAPTURE | 流数据用于编码生成照片，即拍照流。 | 227| STREAM_TYPE_POST_VIEW | 流数据用于保存缩略图。 | 228| STREAM_TYPE_ANALYZE | 流数据用于图像分析。 | 229| STREAM_TYPE_CUSTOM | 自定义类型。 | 230| STREAM_TYPE_DEPTH | 深度流类型。 | 231