1# Enums 2<!--Kit: Camera Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @qano--> 5<!--Designer: @leo_ysl--> 6<!--Tester: @xchaosioda--> 7<!--Adviser: @zengyawen--> 8 9> **说明：** 10> 11> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 12 13## CameraPosition 14 15枚举，相机位置。 16 17**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 18 19**系统能力：** SystemCapability.Multimedia.Camera.Core 20 21| 名称 | 值 | 说明 | 22| --------------------------- | ---- |-----------------------------------------------------------------| 23| CAMERA_POSITION_UNSPECIFIED | 0 | 相对于设备屏幕没有固定的朝向的相机。 | 24| CAMERA_POSITION_BACK | 1 | 后置相机。 | 25| CAMERA_POSITION_FRONT | 2 | 前置相机。 | 26| CAMERA_POSITION_FOLD_INNER<sup>(deprecated)</sup> | 3 | 折叠态相机。<br/> 从API version 11开始支持，从API version 12开始废弃。 | 27 28## CameraType 29 30枚举，相机类型。 31 32**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 33 34**系统能力：** SystemCapability.Multimedia.Camera.Core 35 36| 名称 | 值 | 说明 | 37| ----------------------- | ---- | -------------- | 38| CAMERA_TYPE_DEFAULT | 0 | 默认相机类型。 | 39| CAMERA_TYPE_WIDE_ANGLE | 1 | 广角相机。 | 40| CAMERA_TYPE_ULTRA_WIDE | 2 | 超广角相机。 | 41| CAMERA_TYPE_TELEPHOTO | 3 | 长焦相机。 | 42| CAMERA_TYPE_TRUE_DEPTH | 4 | 带景深信息的相机。 | 43 44## ConnectionType 45 46枚举，相机连接类型。 47 48**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 49 50**系统能力：** SystemCapability.Multimedia.Camera.Core 51 52| 名称 | 值 | 说明 | 53| ---------------------------- | ---- | ------------- | 54| CAMERA_CONNECTION_BUILT_IN | 0 | 内置相机。 | 55| CAMERA_CONNECTION_USB_PLUGIN | 1 | USB连接的相机。 | 56| CAMERA_CONNECTION_REMOTE | 2 | 远程连接的相机。 | 57 58## HostDeviceType<sup>15+</sup> 59 60枚举，远端相机设备类型。 61 62**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 63 64**系统能力：** SystemCapability.Multimedia.Camera.Core 65 66| 名称 | 值 | 说明 | 67| ---------------------------- | ---- |---------| 68| UNKNOWN_TYPE | 0 | 未知设备类型。 | 69| PHONE | 0x0E | 手机设备。 | 70| TABLET | 0x11 | 平板设备。 | 71 72## CameraStatus 73 74枚举，相机状态。 75 76**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 77 78**系统能力：** SystemCapability.Multimedia.Camera.Core 79 80| 名称 | 值 | 说明 | 81| ------------------------- | ---- | ------------ | 82| CAMERA_STATUS_APPEAR | 0 | 新的相机出现。 | 83| CAMERA_STATUS_DISAPPEAR | 1 | 相机被移除。 | 84| CAMERA_STATUS_AVAILABLE | 2 | 相机可用。 | 85| CAMERA_STATUS_UNAVAILABLE | 3 | 相机不可用。 | 86 87## FoldStatus<sup>12+</sup> 88 89枚举，折叠机折叠状态。 90 91**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 92 93**系统能力：** SystemCapability.Multimedia.Camera.Core 94 95| 名称 | 值 | 说明 | 96| ------------------------- | ---- | ------------ | 97| NON_FOLDABLE | 0 | 表示当前设备不可折叠。 | 98| EXPANDED | 1 | 表示当前设备折叠状态为完全展开。 | 99| FOLDED | 2 | 表示当前设备折叠状态为折叠。 | 100 101## SceneMode<sup>11+</sup> 102 103枚举，相机模式。 104 105**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 106 107**系统能力：** SystemCapability.Multimedia.Camera.Core 108 109| 名称 | 值 | 说明 | 110|----------------------------|---------|---------------------------------------------| 111| NORMAL_PHOTO | 1 | 普通拍照模式。详情见[PhotoSession](arkts-apis-camera-PhotoSession.md) | 112| NORMAL_VIDEO | 2 | 普通录像模式。详情见[VideoSession](arkts-apis-camera-VideoSession.md) | 113| SECURE_PHOTO<sup>12+</sup> | 12 | 安全相机模式。详情见[SecureSession](arkts-apis-camera-SecureSession.md) | 114 115## CameraErrorCode 116 117相机错误码。 118 119接口使用不正确以及on接口监听error状态返回。 120 121**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 122 123**系统能力：** SystemCapability.Multimedia.Camera.Core 124 125| 名称 | 值 | 说明 | 126| ------------------------- | ---- | ------------ | 127| INVALID_ARGUMENT | 7400101 | 参数缺失或者参数类型不对。 | 128| OPERATION_NOT_ALLOWED | 7400102 | 操作流程不对，不允许。 | 129| SESSION_NOT_CONFIG | 7400103 | session 未配置返回。 | 130| SESSION_NOT_RUNNING | 7400104 | session 未运行返回。 | 131| SESSION_CONFIG_LOCKED | 7400105 | session 配置已锁定返回。 | 132| DEVICE_SETTING_LOCKED | 7400106 | 设备设置已锁定返回。 | 133| CONFLICT_CAMERA | 7400107 | 设备重复打开返回。 | 134| DEVICE_DISABLED | 7400108 | 安全原因相机被禁用。 | 135| DEVICE_PREEMPTED | 7400109 | 相机被抢占导致无法使用。 | 136| UNRESOLVED_CONFLICTS_WITH_CURRENT_CONFIGURATIONS<sup>12+</sup> | 7400110 | 与当前配置存在冲突。 | 137| SERVICE_FATAL_ERROR | 7400201 | 相机服务错误返回。 | 138 139## TorchMode<sup>11+</sup> 140 141枚举，手电筒模式。 142 143**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 144 145**系统能力：** SystemCapability.Multimedia.Camera.Core 146 147| 名称 | 值 | 说明 | 148| ---------------------------- | ---- | ------------- | 149| OFF | 0 | 常关模式。 | 150| ON | 1 | 常开模式。 | 151| AUTO | 2 | 自动模式，系统根据环境自动调节手电筒亮度。| 152 153## CameraFormat 154 155枚举，输出格式。 156 157**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 158 159**系统能力：** SystemCapability.Multimedia.Camera.Core 160 161| 名称 | 值 | 说明 | 162| ----------------------- | --------- | ------------ | 163| CAMERA_FORMAT_RGBA_8888 | 3 | RGBA_8888格式的图片。 | 164| CAMERA_FORMAT_YUV_420_SP| 1003 | YUV_420_SP格式的图片，对应为NV21格式的图片。 | 165| CAMERA_FORMAT_JPEG | 2000 | JPEG格式的图片。 | 166| CAMERA_FORMAT_YCBCR_P010<sup>11+</sup> | 2001 | YCBCR_P010格式的图片。 | 167| CAMERA_FORMAT_YCRCB_P010<sup>11+</sup> | 2002 | YCRCB_P010格式的图片。 | 168| CAMERA_FORMAT_HEIC<sup>13+</sup> | 2003 | HEIF格式的图片。 | 169 170## VideoCodecType<sup>13+</sup> 171 172枚举，视频编码类型。 173 174**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 175 176**系统能力：** SystemCapability.Multimedia.Camera.Core 177 178| 名称 | 值 | 说明 | 179|------|------|-------------| 180| AVC | 0 | 视频编码类型AVC。| 181| HEVC | 1 | 视频编码类型HEVC。| 182 183## CameraConcurrentType<sup>18+</sup> 184 185枚举，镜头并发类型。 186 187**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 188 189**系统能力：** SystemCapability.Multimedia.Camera.Core 190 191| 名称 | 值 | 说明 | 192|------|------|-------------| 193| CAMERA_LIMITED_CAPABILITY | 0 | 镜头受限能力并发。 | 194| CAMERA_FULL_CAPABILITY | 1 | 镜头全量能力并发。 | 195 196## ImageRotation 197 198枚举，图片旋转角度。 199 200**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 201 202**系统能力：** SystemCapability.Multimedia.Camera.Core 203 204| 名称 | 值 | 说明 | 205| ------------ | ---- | ------------- | 206| ROTATION_0 | 0 | 图片旋转0度。 | 207| ROTATION_90 | 90 | 图片旋转90度。 | 208| ROTATION_180 | 180 | 图片旋转180度。 | 209| ROTATION_270 | 270 | 图片旋转270度。 | 210 211## QualityLevel 212 213枚举，图片质量。 214 215**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 216 217**系统能力：** SystemCapability.Multimedia.Camera.Core 218 219| 名称 | 值 | 说明 | 220| -------------------- | ---- | ------------ | 221| QUALITY_LEVEL_HIGH | 0 | 图片质量高。 | 222| QUALITY_LEVEL_MEDIUM | 1 | 图片质量中等。 | 223| QUALITY_LEVEL_LOW | 2 | 图片质量差。 | 224 225## MetadataObjectType 226 227枚举，metadata流。 228 229**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 230 231**系统能力：** SystemCapability.Multimedia.Camera.Core 232 233| 名称 | 值 | 说明 | 234| ------------------------- | ---- | ----------------- | 235| FACE_DETECTION | 0 | metadata对象类型，用于人脸检测。 | 236 237## FlashMode 238 239枚举，闪光灯模式。 240 241**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 242 243**系统能力：** SystemCapability.Multimedia.Camera.Core 244 245| 名称 | 值 | 说明 | 246| ---------------------- | ---- | ---------- | 247| FLASH_MODE_CLOSE | 0 | 闪光灯关闭。 | 248| FLASH_MODE_OPEN | 1 | 闪光灯打开。 | 249| FLASH_MODE_AUTO | 2 | 自动闪光灯。 | 250| FLASH_MODE_ALWAYS_OPEN | 3 | 闪光灯常亮。 | 251 252## ExposureMode 253 254枚举，曝光模式。 255 256**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 257 258**系统能力：** SystemCapability.Multimedia.Camera.Core 259 260| 名称 | 值 | 说明 | 261| ----------------------------- | ---- | ----------- | 262| EXPOSURE_MODE_LOCKED | 0 | 锁定曝光模式。不支持曝光区域中心点设置。 | 263| EXPOSURE_MODE_AUTO | 1 | 自动曝光模式。支持曝光区域中心点设置，可以使用[AutoExposure.setMeteringPoint](arkts-apis-camera-AutoExposure.md#setmeteringpoint11)接口设置曝光区域中心点。 | 264| EXPOSURE_MODE_CONTINUOUS_AUTO | 2 | 连续自动曝光。不支持曝光区域中心点设置。 | 265 266## FocusMode 267 268枚举，焦距模式。 269 270**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 271 272**系统能力：** SystemCapability.Multimedia.Camera.Core 273 274| 名称 | 值 | 说明 | 275| -------------------------- | ---- | ------------ | 276| FOCUS_MODE_MANUAL | 0 | 手动对焦。通过手动修改相机焦距来改变对焦位置，不支持对焦点设置。 | 277| FOCUS_MODE_CONTINUOUS_AUTO | 1 | 连续自动对焦。不支持对焦点设置。 | 278| FOCUS_MODE_AUTO | 2 | 自动对焦。支持对焦点设置，可以使用[Focus.setFocusPoint](arkts-apis-camera-Focus.md#setfocuspoint11)设置对焦点，根据对焦点执行一次自动对焦。 | 279| FOCUS_MODE_LOCKED | 3 | 对焦锁定。不支持对焦点设置。 | 280 281## FocusState 282 283枚举，焦距状态。 284 285**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 286 287**系统能力：** SystemCapability.Multimedia.Camera.Core 288 289| 名称 | 值 | 说明 | 290| --------------------- | ---- | --------- | 291| FOCUS_STATE_SCAN | 0 | 触发对焦。 | 292| FOCUS_STATE_FOCUSED | 1 | 对焦成功。 | 293| FOCUS_STATE_UNFOCUSED | 2 | 未完成对焦。 | 294 295## VideoStabilizationMode 296 297枚举，视频防抖模式。 298 299**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 300 301**系统能力：** SystemCapability.Multimedia.Camera.Core 302 303| 名称 | 值 | 说明 | 304| --------- | ---- | ------------ | 305| OFF | 0 | 关闭视频防抖功能。 | 306| LOW | 1 | 使用基础防抖算法。 | 307| MIDDLE | 2 | 使用防抖效果一般的防抖算法，防抖效果优于LOW类型。 | 308| HIGH | 3 | 使用防抖效果最好的防抖算法，防抖效果优于MIDDLE类型。 | 309| AUTO | 4 | 自动进行选择防抖算法。 | 310 311## SmoothZoomMode<sup>11+</sup> 312 313平滑变焦模式。 314 315**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 316 317**系统能力：** SystemCapability.Multimedia.Camera.Core 318 319| 名称 | 值 | 说明 | 320| ------------ | ---- | -------------- | 321| NORMAL | 0 | 贝塞尔曲线模式。 | 322 323## PreconfigType<sup>12+</sup> 324 325枚举，提供预配置的类型。 326 327**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 328 329**系统能力：** SystemCapability.Multimedia.Camera.Core 330 331| 名称 | 值 | 说明 | 332|-------------------------|---|------------| 333| PRECONFIG_720P | 0 | 720P预配置。 | 334| PRECONFIG_1080P | 1 | 1080P预配置。 | 335| PRECONFIG_4K | 2 | 4K预配置。 | 336| PRECONFIG_HIGH_QUALITY | 3 | 高质量预配置。 | 337 338## PreconfigRatio<sup>12+</sup> 339 340枚举，提供预配置的分辨率比例。 341 342**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 343 344**系统能力：** SystemCapability.Multimedia.Camera.Core 345 346| 名称 | 值 | 说明 | 347|--------------------------|---|---------| 348| PRECONFIG_RATIO_1_1 | 0 | 1:1画幅。 | 349| PRECONFIG_RATIO_4_3 | 1 | 4:3画幅。 | 350| PRECONFIG_RATIO_16_9 | 2 | 16:9画幅。 | 351 352## QualityPrioritization<sup>14+</sup> 353 354枚举，录像质量优先级。 355 356**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 357 358**系统能力：** SystemCapability.Multimedia.Camera.Core 359 360| 名称 | 值 | 说明 | 361| ------------- | --- | ---------- | 362| HIGH_QUALITY | 0 | 高录像质量。 | 363| POWER_BALANCE | 1 | 功耗平衡的录像质量。 | 364 365## WhiteBalanceMode<sup>20+</sup> 366 367枚举，白平衡模式。 368 369**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 370 371**系统能力：** SystemCapability.Multimedia.Camera.Core 372 373| 名称 | 值 | 说明 | 374|----------------|---| ----------- | 375| AUTO | 0 | 自动 | 376| CLOUDY | 1 | 阴天 | 377| INCANDESCENT | 2 | 白炽光 | 378| FLUORESCENT | 3 | 荧光 | 379| DAYLIGHT | 4 | 日光 | 380| MANUAL | 5 | 手动 | 381| LOCKED | 6 | 锁定 | 382 383## SystemPressureLevel<sup>20+</sup> 384 385枚举，系统压力等级。 386 387**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 388 389**系统能力：** SystemCapability.Multimedia.Camera.Core 390 391| 名称 | 值 | 说明 | 392|--------------------------|---|------------| 393| SYSTEM_PRESSURE_NORMAL | 0 | 系统压力正常。 | 394| SYSTEM_PRESSURE_MILD | 1 | 系统压力升高，但是系统不会主动管控。 | 395| SYSTEM_PRESSURE_SEVERE | 2 | 系统压力可能对图像总质量、性能产生影响。 | 396| SYSTEM_PRESSURE_CRITICAL | 3 | 系统压力对图像质量、性能产生显著影响。 | 397| SYSTEM_PRESSURE_SHUTDOWN | 4 | 系统压力过高，停止工作。 | 398 399## ControlCenterEffectType<sup>20+</sup> 400 401枚举，相机控制器支持的效果类型。 402 403**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 404 405**系统能力：** SystemCapability.Multimedia.Camera.Core 406 407| 名称 | 值 | 说明 | 408|-----------|---|---------| 409| BEAUTY | 0 | 美颜。 | 410| PORTRAIT | 1 | 人像虚化。|