Camera2API笔记

已于 2025-07-13 23:39:47 修改
阅读量1.2k 收藏 20
点赞数 9
CC 4.0 BY-SA版权
文章标签： Camera2
于 2025-07-10 22:57:45 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/tq1086/article/details/149260452

1. 常用对象

  1. CameraManager 相机服务。用于获取相机对象和相机信息。
  2. CameraDevices 相机设备。负责连接相机、创建会话、生成拍摄请求，管理相机生命周期。
  3. CameraCaptureSession 相机拍摄会话。用于预览和拍摄。一个相机只能有一个活跃会话。打开新会话时，旧会话自动关闭。
  4. SessionConfiguration 拍摄会话配置。
  5. CaptureRequest 拍摄请求。通知相机进行拍摄。每个请求产生一个CaptureResult对象，并为目标Surface产生帧。请求可以通过addTarget关联若干个Surface，但它们必须是创建拍摄会话时使用的Surface的子集。
  6. CameraCharacteristics 相机信息。
  7. CaptureResult 部分拍摄结果信息。
  8. TotalCaptureResult 完整拍摄结果信息。
  9. ImageReader 图片读取器。接收图片的对象。
  10. Surface 底片。接收或展示原始影像的对象，是数据管道终点。可以绑定到SurfaceView（预览）、ImageReader（获取图像）或MediaRecorder（录制视频）。

2. 监听器

  1. CameraDevice.StateCallback 相机状态监听器。
  2. CameraCaptureSession.StateCallback 相机拍摄会话状态监听器。
  3. CameraCaptureSession.CaptureCallback 拍摄结果监听器。CaptureCallback只通知结果，图片需要从ImageReader.OnImageAvailableListener中获取。CaptureCallback和OnImageAvailableListener不保证发生顺序。
  4. ImageReader.OnImageAvailableListener 图片监听器。
  5. SurfaceTexture.OnFrameAvailableListener 帧就绪监听器。
  6. MediaRecorder.OnInfoListener​ 录制状态监听器。
  7. MediaRecorder.OnErrorListener 录制错误监听器。

3. 使用Camera2 API时涉及的线程/进程

  1. 相机服务进程 cameraserver系统进程（用户态服务），负责管理相机硬件资源、处理底层传感器控制和图像处理流水线。包括打开/关闭相机设备、配置会话、处理捕获请求和返回元数据，通过Binder与应用进程通信。
  2. 图像渲染线程 处理预览画面和拍照结果的渲染，通常与显示界面（如 SurfaceView/TextureView）绑定。
    1. SurfaceView 由系统单独创建渲染线程（非主线程），通过双缓冲机制高效更新预览画面。
    2. TextureView 依赖主线程或 OpenGL 线程渲染，需开启硬件加速，但更灵活（支持缩放、旋转）。
    3. 数据接收 通过ImageReader的OnImageAvailableListener在子线程中异步接收图像数据。
  3. 应用主线程 管理UI交互、权限请求、生命周期回调，并协调其他线程的工作。所有Camera2耗时操作（如打开相机、创建会话）需在后台线程执行，避免阻塞UI。通常使用HandlerThread配合Handler处理回调。通过Handler将相机事件（如 onCaptureCompleted）从后台线程转发到主线程更新UI。

4. CaptureRequest分类

  1. 重复请求。通过setRepeatingRequest()提交的请求会持续执行，形成一个持续请求链，直到被手动停止（stopRepeating()）或被新请求覆盖。主要用于预览等需连续输出图像流的场景，例如实时显示摄像头画面。重复请求不阻塞后续请求，系统自动按帧率持续处理。但优先级较低，可被单次请求（如拍照）中断。中断后需要手动恢复预览。
  2. 单次请求。通过capture()或captureBurst()提交，执行后自动清除。适用于拍照、手动对焦锁定等需即时触发的操作。单次请求优先级高，会中断重复请求运行。请求提交后立即返回，拍摄结果通过回调异步返回。

在CameraCaptureSession中，可以连续且不等待拍摄完成就发送新CaptureRequest。但要注意避免请求过多超出流水线容量，导致帧丢弃或延迟。可以通过CaptureCallback监听状态，控制请求频率。通过CameraCharacteristics的REQUEST_PIPELINE_MAX_DEPTH可以得到流水线容量。

5. 预览和拍摄的一般流程

  1. 打开相机和拍摄会话。
  2. 发送预览重复请求。开始预览。
  3. 等待3A状态稳定。
  4. 锁定3A状态。
  5. 拍摄。等待拍摄完成。拍摄操作会自动中断预览。
  6. 再次发送预览重复请求。继续预览。

6. 拍摄一张照片需要确认下列资源或状态就绪

  1. 资源就绪。
    1. 获得授权。
    2. 相机CameraDevice就绪。
    3. 相机拍摄会话CameraCaptureSession就绪。
    4. 图像阅读器ImageReader就绪（提供Surface）。
  2. 3A状态就绪。
    1. 自动曝光AE收敛（AE_STATE_CONVERGED）或锁定（AE_STATE_LOCKED）。否则可能过曝/欠曝。
    2. 自动对焦AF锁定（AF_STATE_FOCUSED_LOCKED）。连续对焦模式下可以容忍ACTIVE_SCAN状态。否则可能主体模糊或焦点偏移。
    3. 自动白平衡AWB收敛（AWB_STATE_CONVERGED）。否则可能产生色偏。
  3. 其他状态
    1. 闪光灯充电完成（FLASH_STATE_READY）。否则可能导致闪光失败或亮度不足。
    2. 光学防抖OIS镜片稳定（LENS_STATE_STATIONARY）。否则可能防抖不生效。
    3. 降噪模式（NOISE_REDUCTION_MODE_HIGH_QUALITY）。否则可能降噪算法不生效。
    4. 传感器稳定性（SENSOR_SENSITIVITY）。

7. 中断3A算法的操作

  1. 切换控制模式CONTROL_MODE。
  2. 切换场景模式SCENE_MODE。
  3. 触发3A操作。
  4. 锁定或解锁3A参数。
  5. 停止预览流stopRepeating()。
  6. 请求中包含与当前3A参数冲突的3A参数。
  7. 重启相机或会话。
  8. 光线剧烈变化。

8. 拍摄请求处理路径

代码1  拍摄请求处理路径

CameraCaptureSessionImpl.capture
  CameraDeviceImpl.capture
    CameraDeviceImpl.submitCaptureRequest
      检查Target和Surface
        throw "Each request must have at least one Surface target"
        throw "Null Surface targets are not allowed"
      stopRepeating() // 中断重复请求。
      ICameraDeviceUserWrapper.submitRequestList()
        ICameraDeviceUser.submitRequestList()
          // 通过ICameraDeviceUser.aidl调用C++代码。
          CameraDeviceClient::submitRequestList
            Camera3Device::captureList
              Camera3Device::submitRequestsHelper
                if (repeating) 
                  Camera3Device::RequestThread::setRepeatingRequests
                    List<sp<CaptureRequest>> mRepeatingRequests.push_back
                    // 后续由Camera3Device::RequestThread异步处理。
                else
                  Camera3Device::RequestThread::queueRequestList
                    List<sp<CaptureRequest>> mRequestQueue.push_back
                    // 后续由Camera3Device::RequestThread异步处理。

9. 后台线程主循环

Camera3Device::RequestThread::threadLoop() {
    waitForNextRequestBatch();
    prepareHalRequests();
    sendRequestsBatch();
      Camera3Device::HalInterface::processBatchCaptureRequests
        CameraDeviceSession::processCaptureRequest
          CameraDeviceSession::processOneCaptureRequest
            camera3_device_t->ops->process_capture_request
              camera3_device_ops.process_capture_request
                // 通用实现。
                Camera::processCaptureRequest
                  Camera::processCaptureBuffer
}

10. 使用DngCreator保存RAW_SENSOR影像的条件

  1. 拍摄完成，已经得到TotalCaptureResult结果。
  2. ImageReader.OnImageAvailableListener已经收到图片。

11. CaptureCallback用于跟踪拍摄请求处理进度

  1. onCaptureStarted 相机开始拍摄（曝光）
  2. onReadoutStarted 相机开始读取传感器数据
  3. onCapturePartial 拍摄获得部分结果
  4. onCaptureProgressed 拍摄获得进展
  5. onCaptureCompleted 单次拍摄完成
  6. onCaptureFailed 拍摄失败
  7. onCaptureSequenceCompleted 拍摄序列全部完成
  8. onCaptureSequenceAborted 拍摄序列中断
  9. onCaptureBufferLost

12. CaptureRequest/Response参数

12.1. 控制参数

12.1.1. CONTROL_AE_ANTIBANDING_MODE 防摩尔纹模式
枚举值具体值说明
CONTROL_AE_ANTIBANDING_MODE_OFF0关闭防摩尔纹
CONTROL_AE_ANTIBANDING_MODE_50HZ1防50Hz摩尔纹
CONTROL_AE_ANTIBANDING_MODE_60HZ2防60Hz摩尔纹
CONTROL_AE_ANTIBANDING_MODE_AUTO3自动防摩尔纹
12.1.2. CONTROL_AE_EXPOSURE_COMPENSATION 曝光补偿
取值范围CONTROL_AE_COMPENSATION_RANGE
步长CONTROL_AE_COMPENSATION_STEP
12.1.3. CONTROL_AE_LOCK AE锁定状态
具体值说明
true锁定
false未锁定
12.1.4. CONTROL_AE_MODE 自动曝光模式
枚举值具体值说明
CONTROL_AE_MODE_OFF0关闭自动曝光
CONTROL_AE_MODE_ON1启用自动曝光
CONTROL_AE_MODE_ON_AUTO_FLASH2自动使用闪光灯
CONTROL_AE_MODE_ON_ALWAYS_FLASH3始终使用闪光灯
CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE4自动使用闪光灯去红眼
CONTROL_AE_MODE_ON_EXTERNAL_FLASH5使用外部闪光灯
12.1.5. CONTROL_AE_REGIONS AE测光区域
具体值说明
MeteringRectangle数组AE测光区域
12.1.6. CONTROL_AE_TARGET_FPS_RANGE 目标FPS范围
取值范围CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES
步长1
12.1.7. CONTROL_AE_PRECAPTURE_TRIGGER AE预捕获触发
枚举值具体值说明
CONTROL_AE_PRECAPTURE_TRIGGER_IDLE0空闲
CONTROL_AE_PRECAPTURE_TRIGGER_START1开始
CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL2取消
12.1.8. CONTROL_AF_MODE AF模式
枚举值具体值说明
CONTROL_AF_MODE_OFF0关闭自动对焦
CONTROL_AF_MODE_AUTO1启用自动对焦
CONTROL_AF_MODE_MACRO2
CONTROL_AF_MODE_CONTINUOUS_VIDOE3
CONTROL_AF_MODE_CONTINUOUS_PICTURE4
CONTROL_AF_MODE_EDOF5
12.1.9. CONTROL_AF_REGIONS 对焦区域
具体值说明
MeteringRectangle数组对焦区域
12.1.10. CONTROL_AF_TRIGGER AF触发模式
枚举值具体值说明
CONTROL_AF_TRIGGER_IDLE0
CONTROL_AF_TRIGGER_START1
CONTROL_AF_TRIGGER_CANCEL2
12.1.11. CONTROL_AWB_LOCK AWB锁定
具体值说明
true锁定
false未锁定
12.1.12. CONTROL_AWB_MODE 自动白平衡模式
枚举值具体值说明
CONTROL_AWB_MODE_OFF0关闭自动白平衡
CONTROL_AWB_MODE_AUTO1启用自动白平衡
CONTROL_AWB_MODE_INCANDESCENT2白炽灯白平衡
CONTROL_AWB_MODE_FLUORESCENT3荧光灯白平衡
CONTROL_AWB_MODE_WARM_FLUORESCENT4暖白色荧光灯白平衡
CONTROL_AWB_MODE_DAYLIGHT5日光白平衡
CONTROL_AWB_MODE_CLOUDY_DAYLIGHT6阴天日光白平衡
CONTROL_AWB_MODE_TWILIGHT7暮光白平衡
CONTROL_AWB_MODE_SHADE8阴影光白平衡
12.1.13. CONTROL_AWB_REGIONS AWB测光区域
具体值说明
MeteringRectangle数组AWB测光区域
12.1.14. CONTROL_CAPTURE_INTENT 拍摄意图
枚举值具体值说明
CONTROL_CAPTURE_INTENT_CUSTOM0预览模式行为
CONTROL_CAPTURE_INTENT_PREVIEW1预览
CONTROL_CAPTURE_INTENT_STILL_CAPTURE2静态图像拍摄
CONTROL_CAPTURE_INTENT_VIDEO_RECORD3视频录制
CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT4视频录制时截取静态图像
CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG5零快门延迟
CONTROL_CAPTURE_INTENT_MANUAL6手动控制参数
CONTROL_CAPTURE_INTENT_MOTION_TRACKING7运动追踪
12.1.15. CONTROL_EFFECT_MODE 色彩效果
枚举值具体值说明
CONTROL_EFFECT_MODE_OFF0关闭色彩效果
CONTROL_EFFECT_MODE_MONO1单色
CONTROL_EFFECT_MODE_NEGATIVE2负片
CONTROL_EFFECT_MODE_SOLARIZE3中途曝光
CONTROL_EFFECT_MODE_SEPIA4棕褐色调
CONTROL_EFFECT_MODE_POSTERIZE5色调分离
CONTROL_EFFECT_MODE_WHITEBOARD6白板效果
CONTROL_EFFECT_MODE_BLACKBOARD7黑板效果
CONTROL_EFFECT_MODE_AQUA8水彩风格
12.1.16. CONTROL_MODE 控制模式
枚举值具体值说明
CONTROL_MODE_OFF0关闭3A算法
CONTROL_MODE_AUTO1自动控制3A算法
CONTROL_MODE_USE_SCENE_MODE2使用场景模式3A算法
CONTROL_MODE_OFF_KEEP_STATE3
CONTROL_MODE_USE_EXTENDED_SCENE_MODE4
12.1.17. CONTROL_SCENE_MODE 场景模式
枚举值具体值说明
CONTROL_SCENE_MODE_DISABLED0关闭场景模式
CONTROL_SCENE_MODE_FACE_PRIORITY1人脸检测模式
CONTROL_SCENE_MODE_ACTION2快速移动物体
CONTROL_SCENE_MODE_PORTRAIT3人像
CONTROL_SCENE_MODE_LANDSCAPE4日常物体
CONTROL_SCENE_MODE_NIGHT5暗光
CONTROL_SCENE_MODE_NIGHT_PORTRAIT6暗光人像
CONTROL_SCENE_MODE_THEATRE7剧场
CONTROL_SCENE_MODE_BEACH8沙滩
CONTROL_SCENE_MODE_SNOW9雪地
CONTROL_SCENE_MODE_SUNSET10日落
CONTROL_SCENE_MODE_STEADYPHOTO11防止手抖
CONTROL_SCENE_MODE_FIREWORKS12夜晚焰火
CONTROL_SCENE_MODE_SPORTS13快速移动人像
CONTROL_SCENE_MODE_PARTY14聚会
CONTROL_SCENE_MODE_CANDLELIGHT15烛光
CONTROL_SCENE_MODE_BARCODE16二维码
CONTROL_SCENE_MODE_HDR18HDR
CONTROL_SCENE_MODE_FACE_PRIORITY_LOW_LIGHT19
12.1.18. CONTROL_POST_RAW_SENSITIVITY_BOOST RAW图像ISO增强
取值范围CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE
步长1
12.1.19. CONTROL_ENABLE_ZSL 启用零延时缓冲
具体值说明
true启用
false停用

12.2. 传感器参数

12.2.1. SENSOR_EXPOSURE_TIME 曝光时间(纳秒)
取值范围SENSOR_INFO_EXPOSURE_TIME_RANGE
步长1
12.2.2. SENSOR_FRAME_DURATION 帧处理（含曝光）时间（纳秒）
取值范围SENSOR_INFO_MAX_FRAME_DURATION
步长1
12.2.3. SENSOR_SENSITIVITY ISO感光度
取值范围SENSOR_INFO_SENSITIVITY_RANGE
步长1
12.2.4. SENSOR_NEUTRAL_COLOR_POINT 中性色点坐标（输出参数）
12.2.5. SENSOR_GREEN_SPLIT G通道分割值（输出参数）
12.2.6. SENSOR_NOISE_PROFILE 噪声模型参数（输出参数）
12.2.7. SENSOR_PIXEL_MODE 像素模式
枚举值具体值说明
SENSOR_PIXEL_MODE_DEFAULT0
SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION1不合并像素
12.2.8. SENSOR_TEST_PATTERN_MODE 传感器测试模式
枚举值具体值说明
SENSOR_TEST_PATTERN_MODE_OFF0关闭传感器测试模式
SENSOR_TEST_PATTERN_MODE_SOLID_COLOR1
SENSOR_TEST_PATTERN_MODE_COLOR_BARS2
SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY3
SENSOR_TEST_PATTERN_MODE_PN94
SENSOR_TEST_PATTERN_MODE_BLACK5
SENSOR_TEST_PATTERN_MODE_CUSTOM1256

12.3. 镜头参数

12.3.1. LENS_APERTURE 光圈值
12.3.2. LENS_FILTER_DENSITY ND滤镜密度
12.3.3. LENS_FOCAL_LENGTH 焦距（毫米）
12.3.4. LENS_FOCUS_DISTANCE 对焦距离（屈光度）
12.3.5. LENS_OPTICAL_STABILIZATION_MODE OIS模式
枚举值具体值说明
LENS_OPTICAL_STABILIZATION_MODE_OFF0停用OIS
LENS_OPTICAL_STABILIZATION_MODE_ON1启用OIS
12.3.6. LENS_FOCUS_RANGE 对焦范围（[近点, 远点]屈光度）（输出参数）
12.3.7. LENS_POSE_ROTATION 镜头旋转（四元数）（输出参数）
12.3.8. LENS_POSE_TRANSLATION 镜头平移（输出参数）
12.3.9. LENS_INTRINSIC_CALIBRATION 本征校准参数（输出参数）

12.4. 闪光灯参数

12.4.1. FLASH_MODE 闪光模式
枚举值具体值说明
FLASH_MODE_OFF0关闭闪光灯
FLASH_MODE_SINGLE1使用闪光灯
FLASH_MODE_TORCH2闪光灯常量

12.5. JPEG参数

12.5.1. JPEG_QUALITY JPEG压缩质量
取值范围[1,100]
步长1
说明1质量最低，100质量最高。
12.5.2. JPEG_THUMBNAIL_QUALITY 缩略图质量
取值范围[1,100]
步长1
说明1质量最低，100质量最高。
12.5.3. JPEG_THUMBNAIL_SIZE 缩略图尺寸
具体值说明
Size对象缩略图尺寸
12.5.4. JPEG_ORIENTATION JPEG方向
具体值说明
0
90
180
270
12.5.5. JPEG_GPS_LOCATION GPS信息
具体值说明
Location对象
12.5.6. JPEG_GPS_PROCESSING_METHOD GPS处理方法
具体值说明
String对象
12.5.7. JPEG_GPS_TIMESTAMP GPS时间戳
12.5.8. JPEG_GPS_COORDINATES GPS坐标

12.6. 处理参数

12.6.1. EDGE_MODE 边缘增强模式
枚举值具体值说明
EDGE_MODE_OFF0关闭边缘增强
EDGE_MODE_FAST1快速边缘增强
EDGE_MODE_HIGH_QUALITY2高质量边缘增强
EDGE_MODE_ZERO_SHUTTER_LAG3瞬间边缘增强
12.6.2. HOT_PIXEL_MODE 坏点校正模式
枚举值具体值说明
HOT_PIXEL_MODE_OFF0关闭坏点校正
HOT_PIXEL_MODE_FAST1快速坏点校正
HOT_PIXEL_MODE_HIGH_QUALITY2高质量坏点校正
12.6.3. NOISE_REDUCTION_MODE 降噪模式
枚举值具体值说明
NOISE_REDUCTION_MODE_OFF0关闭降噪
NOISE_REDUCTION_MODE_FAST1快速降噪
NOISE_REDUCTION_MODE_HIGH_QUALITY2高质量降噪
NOISE_REDUCTION_MODE_MINIMAL3极简降噪
12.6.4. TONEMAP_CURVE 色调映射曲线
具体值说明
TonemapCurve对象
12.6.5. TONEMAP_GAMMA 伽马值
取值范围[1.0,5.0]
12.6.6. TONEMAP_PRESET_CURVE 预设色调曲线
枚举值具体值说明
TONEMAP_PRESET_CURVE_SRGB0sRGB曲线
TONEMAP_PRESET_CURVE_REC7091ITU-R BT.709曲线
12.6.7. COLOR_CORRECTION_ABERRATION_MODE 色差校正
取值范围COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES
枚举值具体值说明
COLOR_CORRECTION_ABERRATION_MODE_OFF0关闭色差矫正
COLOR_CORRECTION_ABERRATION_MODE_FAST1快速色差矫正
COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY2高质量色差矫正
12.6.8. COLOR_CORRECTION_GAINS 白平衡增益
具体值说明
RggbChannelVector对象
12.6.9. COLOR_CORRECTION_MODE 色彩校正模式
枚举值具体值说明
COLOR_CORRECTION_MODE_TRANSFORM_MATRIX0使用TRANSFORM/GAINS进行色彩矫正
COLOR_CORRECTION_MODE_FAST1快速色彩矫正
COLOR_CORRECTION_MODE_HIGH_QUALITY2高质量色彩矫正
12.6.10. COLOR_CORRECTION_TRANSFORM 色彩校正矩阵
具体值说明
ColorSpaceTransform对象
12.6.11. SHADING_MODE 镜头阴影校正
枚举值具体值说明
SHADING_MODE_OFF0关闭镜头阴影矫正
SHADING_MODE_FAST1快速镜头阴影矫正
SHADING_MODE_HIGH_QUALITY2高质量镜头阴影矫正

12.7. 统计参数

12.7.1. STATISTICS_FACE_DETECT_MODE 人脸检测模式
枚举值具体值说明
STATISTICS_FACE_DETECT_MODE_OFF0不返回人脸识别信息
STATISTICS_FACE_DETECT_MODE_SIMPLE1只返回人脸矩形和置信度
STATISTICS_FACE_DETECT_MODE_FULL2返回全部人脸信息
12.7.2. STATISTICS_HOT_PIXEL_MAP_MODE 启用坏点图
12.7.3. STATISTICS_LENS_SHADING_MAP_MODE 镜头阴影图模式
枚举值具体值说明
STATISTICS_LENS_SHADING_MAP_MODE_OFF0不返回镜头阴影图信息
STATISTICS_LENS_SHADING_MAP_MODE_ON1
12.7.4. STATISTICS_INFO_AVAILABLE_FACE_DETECT_MODES 可用的人脸检测模式
12.7.5. STATISTICS_INFO_MAX_FACE_COUNT 最大检测人脸数

12.8. 输出参数

12.8.1. SCALER_CROP_REGION 裁剪区域（数字变焦）
具体值说明
Rect对象
12.8.2. SCALER_ROTATE_AND_CROP 旋转裁剪模式
枚举值具体值说明
SCALER_ROTATE_AND_CROP_NONE0
SCALER_ROTATE_AND_CROP_901
SCALER_ROTATE_AND_CROP_1802
SCALER_ROTATE_AND_CROP_2703
SCALER_ROTATE_AND_CROP_AUTO4

12.9. 逻辑相机参数

12.9.1. LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE 传感器同步类型
枚举值具体值说明
LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_APPROXIMATE0近似同步
LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_CALIBRATED1标定同步
12.9.2. LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_ID 活动的物理相机ID

12.10. Extension参数

12.10.1. EXTENSION_CURRENT_TYPE 当前扩展类型（输出参数）
12.10.2. EXTENSION_STRENGTH 扩展效果强度
取值范围[0,100]
步长1
默认值100

12.11. 其他参数

12.11.1. BLACK_LEVEL_LOCK 黑电平锁定
12.11.2. REPROCESS_EFFECTIVE_EXPOSURE_FACTOR 后处理曝光补偿因子
12.11.3. DISTORTION_CORRECTION_MODE 镜头畸变校正
枚举值具体值说明
DISTORTION_CORRECTION_MODE_OFF0关闭镜头畸变矫正
DISTORTION_CORRECTION_MODE_FAST1快速镜头畸变矫正
DISTORTION_CORRECTION_MODE_HIGH_QUALITY2高质量镜头畸变矫正
12.11.4. LED_TRANSMIT LED传输启用

13. Exif标签

枚举值标签类型说明
TAG_APERTURERational镜头光圈值 TAG_F_NUMBER别名
TAG_APERTURE_VALUERational镜头光圈值 APEX单位
TAG_ARTISTASCII作者
TAG_BITS_PER_SAMPLEShort颜色通道位数
TAG_BRIGHTNESS_VALUESigned Rational图像亮度值 APEX单位
TAG_CFA_PATTERNUndefined彩色滤波阵列模式 Bayer滤镜等
TAG_COLOR_SPACEShort色彩空间 1 sRGB 65535 未校准
TAG_COMPONENTS_CONFIGURATIONUndefined分量配置 Y,Cb,Cr顺序
TAG_COMPRESSED_BITS_PER_PIXELRational每像素压缩位数
TAG_COMPRESSIONShort压缩方案 1未压缩 6JPEG
TAG_CONTRASTShort对比度调整 0正常 1柔和 2强烈
TAG_COPYRIGHTASCII版权信息
TAG_CUSTOM_RENDEREDShort自定义图像处理 0标准 1自定义
TAG_DATETIMEASCII修改时间 YYYY:MM:DD HH:MM:SS
TAG_DATETIME_DIGITIZEDASCII数字化时间 格式同上
TAG_DATETIME_ORIGINALASCII原始拍摄时间 格式同上
TAG_DEFAULT_CROP_SIZELong原始传感器图像的有效区域尺寸
TAG_DEVICE_SETTING_DESCRIPTIONUndefined设备拍摄参数描述
TAG_DIGITAL_ZOOM_RATIORational数字变焦比例 1.0 无变焦
TAG_DNG_VERSIONUndefinedDNG格式版本标识
TAG_EXIF_VERSIONUndefinedEXIF标准版本 如"0230"
TAG_EXPOSURE_BIAS_VALUESigned Rational曝光补偿值 EV单位
TAG_EXPOSURE_INDEXRationalISO感光度实际值 替代TAG_ISO
TAG_EXPOSURE_MODEShort曝光模式 0自动 1手动 2包围
TAG_EXPOSURE_PROGRAMShort曝光程序 1 手动 3 光圈优先等
TAG_EXPOSURE_TIMERational快门速度 以秒为单位的分数值
TAG_FILE_SOURCEUndefined来源设备类型 3 数码相机
TAG_FLASHShort闪光灯状态
TAG_FLASHPIX_VERSIONUndefinedFlashpix格式版本
TAG_FLASH_ENERGYRational闪光灯强度 BCPS
TAG_FOCAL_LENGTHRational实际焦距 毫米
TAG_FOCAL_LENGTH_IN_35MM_FILMLong等效35mm格式焦距
TAG_FOCAL_PLANE_RESOLUTION_UNITShort焦平面分辨率单位 2英寸 3厘米
TAG_FOCAL_PLANE_X_RESOLUTIONRational焦平面X轴分辨率 像素/英寸
TAG_FOCAL_PLANE_Y_RESOLUTIONRational焦平面Y轴分辨率 像素/英寸
TAG_F_NUMBERRationalF光圈值 如f/2.8
TAG_GAIN_CONTROLShort增益调整 0无 1低增益 2高增益
TAG_GPS_ALTITUDERational海拔高度
TAG_GPS_ALTITUDE_REFByte海拔高度参考 0海平面 1负高度
TAG_GPS_AREA_INFORMATIONASCIIGPS区域名称
TAG_GPS_DATESTAMPASCIIGPS日期 YYYY:MM:DD
TAG_GPS_DEST_BEARINGRational目的地方位角 度
TAG_GPS_DEST_BEARING_REFASCII方位角参考 T真北 M磁北
TAG_GPS_DEST_DISTANCERational目的地距离
TAG_GPS_DEST_DISTANCE_REFASCII距离单位 K千米 M英里
TAG_GPS_DEST_LATITUDERational目的地纬度
TAG_GPS_DEST_LATITUDE_REFASCII纬度参考 "N"/"S"
TAG_GPS_DEST_LONGITUDERational目的地经度
TAG_GPS_DEST_LONGITUDE_REFASCII经度参考 "E"/"W"
TAG_GPS_DIFFERENTIALShortGPS差分修正 0无 1已修正
TAG_GPS_DOPRational定位精度因子
TAG_GPS_IMG_DIRECTIONRational图像拍摄方向 度
TAG_GPS_IMG_DIRECTION_REFASCII方向参考 "T"/"M"
TAG_GPS_LATITUDERational纬度 度分秒格式
TAG_GPS_LATITUDE_REFASCII纬度半球 "N"/"S"
TAG_GPS_LONGITUDERational经度 度分秒格式
TAG_GPS_LONGITUDE_REFASCII经度半球 "E"/"W"
TAG_GPS_MAP_DATUMASCII使用的地理坐标系 如"WGS-84"
TAG_GPS_MEASURE_MODEASCIIGPS测量模式 "2" 二维 "3" 三维
TAG_GPS_PROCESSING_METHODUndefinedGPS处理方法 通常含坐标系名称
TAG_GPS_SATELLITESASCII定位使用的卫星数量
TAG_GPS_SPEEDRational拍摄时移动速度 km/h
TAG_GPS_SPEED_REFASCII速度单位 "K" km/h "M" mph等
TAG_GPS_STATUSASCII接收器状态 "A" 有效 "V" 无效
TAG_GPS_TIMESTAMPRationalGPS时间 UTC格式：hh:mm:ss
TAG_GPS_TRACKRational行进方向 度
TAG_GPS_TRACK_REFASCII方向参考 "T"/"M"
TAG_GPS_VERSION_IDByteGPS版本号 通常02.02.00.00
TAG_IMAGE_DESCRIPTIONASCII图像标题或描述
TAG_IMAGE_LENGTHLong/Short图像高度 像素
TAG_IMAGE_UNIQUE_IDASCII图像唯一标识符 16字符
TAG_IMAGE_WIDTHLong/Short图像宽度 像素
TAG_INTEROPERABILITY_INDEXASCII互操作性标准 "R98" Exif R98
TAG_ISOShortISO感光度
TAG_ISO_SPEED_RATINGSShortISO感光度
TAG_JPEG_INTERCHANGE_FORMATLongJPEG缩略图数据偏移量
TAG_JPEG_INTERCHANGE_FORMAT_LENGTHLongJPEG缩略图数据长度
TAG_LIGHT_SOURCEShort光源类型 0未知 1日光 4闪光灯
TAG_MAKEASCII相机/扫描仪制造商
TAG_MAKER_NOTEUndefined制造商私有数据
TAG_MAX_APERTURE_VALUERational最大镜头光圈值 APEX单位
TAG_METERING_MODEShort测光模式 1平均 3点测 5区域
TAG_MODELASCII设备型号
TAG_NEW_SUBFILE_TYPELong子文件类型 0 全分辨率图像
TAG_OECFUndefined光电转换特性
TAG_OFFSET_TIMEASCII时区偏移 格式：±HH:MM
TAG_OFFSET_TIME_DIGITIZEDASCII数字化时间时区偏移
TAG_OFFSET_TIME_ORIGINALASCII原始时间时区偏移
TAG_ORF_ASPECT_FRAMELong(Olympus专用) 图像画幅比例
TAG_ORF_PREVIEW_IMAGE_LENGTHLong(Olympus专用) 预览图高度
TAG_ORF_PREVIEW_IMAGE_STARTLong(Olympus专用) 预览图起始位置
TAG_ORF_THUMBNAIL_IMAGEUndefined(Olympus专用) 缩略图数据
TAG_ORIENTATIONShort图像旋转方向 1正常 6顺时针90°
TAG_PHOTOMETRIC_INTERPRETATIONShort像素数据格式 2 RGB 6 YCbCr
TAG_PIXEL_X_DIMENSIONLong/Short有效图像宽度
TAG_PIXEL_Y_DIMENSIONLong/Short有效图像高度
TAG_PLANAR_CONFIGURATIONShort数据排列方式 1 连续 2 分通道
TAG_PRIMARY_CHROMATICITIESRational主要原色色度坐标
TAG_REFERENCE_BLACK_WHITERational黑/白参考值
TAG_RELATED_SOUND_FILEASCII关联音频文件名 8.3格式
TAG_RESOLUTION_UNITShort分辨率单位 1未指定 2英寸 3厘米
TAG_ROWS_PER_STRIPLong/Short每条带行数
TAG_SAMPLES_PER_PIXELShort每像素采样数 3 RGB 4 CMYK
TAG_SATURATIONShort饱和度调整 0正常 1低 2高
TAG_SCENE_CAPTURE_TYPEShort场景类型 0标准 1风景 2人像
TAG_SCENE_TYPEUndefined场景类别 1 直接拍摄
TAG_SENSING_METHODShort传感器类型 2单芯片 3三线阵
TAG_SHARPNESSShort锐度调整 0正常 1柔和 2锐利
TAG_SHUTTER_SPEED_VALUESigned Rational快门速度值 APEX单位
TAG_SOFTWAREASCII固件/软件版本
TAG_SPATIAL_FREQUENCY_RESPONSEUndefined空间频率响应
TAG_SPECTRAL_SENSITIVITYASCII光谱灵敏度
TAG_STRIP_BYTE_COUNTSLong/Short每压缩条带字节数
TAG_STRIP_OFFSETSLong/Short条带数据偏移量
TAG_SUBFILE_TYPELong子文件类型 旧版替代字段
TAG_SUBJECT_AREAShort主题区域位置 坐标或中心点
TAG_SUBJECT_DISTANCERational对焦距离 米
TAG_SUBJECT_DISTANCE_RANGEShort主体距离 1微距 2近景 3远景
TAG_SUBJECT_LOCATIONShort主体在场景中的位置坐标
TAG_SUBSEC_TIMEASCII日期时间秒的小数部分
TAG_SUBSEC_TIME_DIGASCII数字化时间的秒的小数部分 别名
TAG_SUBSEC_TIME_DIGITIZEDASCII数字化时间的秒的小数部分
TAG_SUBSEC_TIME_ORIGASCII原始时间的秒的小数部分 别名
TAG_SUBSEC_TIME_ORIGINALASCII原始时间的秒的小数部分
TAG_THUMBNAIL_IMAGE_LENGTHLong缩略图高度 像素
TAG_THUMBNAIL_IMAGE_WIDTHLong缩略图宽度 像素
TAG_THUMBNAIL_ORIENTATIONShort缩略图旋转方向
TAG_TRANSFER_FUNCTIONShort色调曲线转换函数
TAG_USER_COMMENTUser Comment用户自定义注释 包含字符集信息
TAG_WHITE_BALANCEShort白平衡设置 0自动 1手动
TAG_WHITE_POINTRational白点色度坐标
TAG_XMPUndefinedAdobe XMP元数据嵌入区
TAG_X_RESOLUTIONRational水平打印分辨率 像素/英寸
TAG_Y_CB_CR_COEFFICIENTSRationalYCbCr变换系数矩阵
TAG_Y_CB_CR_POSITIONINGShort色度分量位置 1 居中 2 并列
TAG_Y_CB_CR_SUB_SAMPLINGShort色度分量下采样比例
TAG_Y_RESOLUTIONRational垂直打印分辨率 像素/英寸
tq1086
关注
android9.0 Camera2 API 使用流程分析（MTK）
zjy764219923的专栏
12-05 1699
camera api2 mtkcam3
RK3568平台开发系列讲解（Camera篇）Camera API v2框架
内核笔记
12-18 1597
📢本篇讲介绍 `Camera API v2`框架。
Android Camera2学习笔记——API
修行的乞丐
01-17 1558
Android Camera2常用API记录
Android Camera2 API
songzi1228的博客
10-28 1067
目录 0、相关文章： 1、简介 2、Camera2 中主要的API类 2.1、CameraManager类 2.2、CameraCharacteristics类 2.2.1、LENS_FACING：获取摄像头方向 2.2.2、SCALER_STREAM_CONFIGURATION_MAP： 2.2.3、SENSOR_ORIENTATION 2.2.4、FLASH_INFO_AVA...
掌握Android Camera2 API：从获取到处理预览帧的完整教程
最新发布
weixin_29903713的博客
06-09 978
简介：在Android平台上，Camera2 API提供了对相机功能的高级访问和控制。"Camera2GetPreview"项目展示了如何使用Camera2 API在Android应用中获取和处理相机预览帧。本课程通过详细介绍Camera2 API组件、获取和处理预览帧的步骤、项目特点及源码学习，帮助开发者深入理解Camera2 API的使用，从而提高Android相机应用开发能力。
Camera2 API
weixin_37391237的博客
11-14 1035
在Android5.0的API中，我们发现之前的camera API被弃用，Google推荐使用最新的相机API：Camera2，它不仅大幅提高了Android系统拍照的功能，还能支持RAW照片输出，，甚至允许程序调整相机对焦模式、曝光模式、快门等。 使用流程 首先系统请求打开摄像头，当摄像头打开后系统请求创建系统与摄像头之间的会话（这里引用管道的概念将Android系统和摄像头设备联通起来），会话（session）创建成功后，系统就可以通过会话发送不同的Capture请求去控制摄像头执行不同的操作。 Ca
Camera API2 使用
yaoming168的专栏
12-14 1395
一、概况 1.现在Google已经开始推广CameraX API了，为什么我们还要学习Camera API2？ 从CameraX源码可以知道CameraX的使用非常简单，原因在于它把Camera2中复杂的API封装到统一的config中，供开发者调用，如果我们想进一步深入理解Android Camera子系统的原理还是需要从Camera2一步步深入。 参考链接： Android Camera-Camera2使用 Android Camera 编程从入门到精通 Android Camera2拍照流程 2.C
Android 笔记 camera2 新api
super_zq的博客
09-07 8696
android.hardware.camera2 API 21，
Android Camera2 API，Android面试题中高级
m0_66264881的博客
03-05 790
2.2.3、SENSOR_ORIENTATION 2.2.4、FLASH_INFO_AVAILABLE 2.2.5、SCALER_AVAILABLE_MAX_DIGITAL_ZOOM 2.2.6、LENS_INFO_MINIMUM_FOCUS_DISTANCE 2.2.7、INFO_SUPPORTED_HARDWARE_LEVEL 2.3、CameraDevice类 2.4、CameraCaptureSession类 2.5、CameraRequest类 0、相关文章： ======= Android C
Camera API2拍照Demo
09-30
使用Camera API2调用摄像头完成拍照的Demo，方便学习Camera API2的接口
camera API2的camera demo
12-09
camera api2的相机应用开发，实现了包括预览，拍照，各对焦切换，预览回调，拍照回调等各camera2所有接口的demo。
翻译Camera2 API
ringcqy的博客
07-07 511
android.hardware.camera2 The android.hardware.camera2 package provides an interface to individual camera devices connected to an Android device. It replaces the deprecated Camera class. camera2包
Android 基于Camera2 API进行摄像机图像预览
ZLGSPACE的博客
11-23 1505
Android Camera2 API 是从 Android 5.0（Lollipop）开始引入的，用以取代旧的 Camera API。Camera2 提供了更强大和灵活的相机控制能力，允许开发者实现更多的相机功能，如手动对焦、手动曝光、原生 RAW 图像捕获等。该博文是博主近期准备实现摄像机编解码系列中的第一篇、如果对此感兴趣的话，欢迎大家关注或者留言，共同进步。
Android Camera开发序列：Camera2 API 的简单描述和调用（预览、拍照、录像）
欢迎关注，期待一起见证彼此的成长~
12-17 1829
Android 5.1 以后，添加了Camera2 的API,能够满足更多操纵camera的场景。当然，相对应camera1的调用，也变的复杂一点。 一、涉及到的关键类 CameraManager -------------- 获取连接的camera情况，执行打开摄像头的操作； CameraDevice -------------...
Camera2 api 获取摄像头预览画面并设置取景框
2301_78330059的博客
07-29 312
【代码】Camera2 api 获取摄像头预览画面并设置取景框。
Android Camera2 API和拍照与录像过程
热门推荐
HeXinGen的博客
02-08 5万+
简介： Android 5.0开始出现了新的相机Camera 2 API，用来替代以前的camera api。 Camera2 API不仅提高了android系统的拍照性能，还支持RAW照片输出，还可以设置相机的对焦模式，曝光模式，快门等等。 Camera2 中主要的API类 CameraManager类 : 摄像头管理类，用于检测、打开系统摄像头，通过getCam...
Camera2 API---------随笔记录
Davinci58的博客
01-22 272
camera2 API使用的一些个人随笔记录
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值