登录
当前位置： 首页 > 工具软件 > Focal Camera > 使用案例 >

Android Camera2 之 CameraCharacteristics 详解

轩辕越泽
2023-12-01

一、简介

CameraCharacteristics 是描述相机设备的属性类，其中的属性都是 固定的，继承自 CameraMetadata 类。类比于旧 API 中的 CameraInfo 类。

包括：曝光补偿（Exposure compensation）、自动曝光/自动对焦/自动白平衡模式（AE / AF / AWB mode）、自动曝光/自动白平衡锁（AE / AWB lock）、自动对焦触发器（AF trigger）、拍摄前自动曝光触发器（Precapture AE trigger）、测量区域（Metering regions）、闪光灯触发器（Flash trigger）、曝光时间（Exposure time）、感光度（ISO Sensitivity）、帧间隔（Frame duration）、镜头对焦距离（Lens focus distance）、色彩校正矩阵（Color correction matrix）、JPEG 元数据（JPEG metadata）、色调映射曲线（Tonemap curve）、裁剪区域（Crop region）、目标 FPS 范围（Target FPS range）、拍摄意图（Capture intent）、硬件视频防抖（Video stabilization）等。

官方文档链接：https://developer.android.google.cn/reference/android/hardware/camera2/CameraCharacteristics

二、获取 CameraCharacteristics 示例

通过 CameraManager 的 getCameraCharacteristics(String cameraId) 方法获取指定相机设备的 CameraCharacteristics 对象。

private int mCameraId = CameraCharacteristics.LENS_FACING_FRONT; // 要打开的摄像头ID
private CameraManager mCameraManager; // 相机管理者
private CameraCharacteristics mCameraCharacteristics; // 相机属性

public void openCamera() {
    try {
        mCameraCharacteristics = mCameraManager.getCameraCharacteristics(Integer.toString(mCameraId));
        StreamConfigurationMap map = mCameraCharacteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
        // ...省略
    } catch (CameraAccessException e) {
        e.printStackTrace();
    }
}

三、内部类

包含一个 CameraCharacteristics.Key<T> 的内部类，用做相机特性的字段查询使用。

常搭配 CameraCharacteristics.get(CameraCharacteristics.Key<T> key) 方法使用。

四、常用方法

1. T get(CameraCharacteristics.Key key)

获取相机属性中对应字段的值。如果输入的 key 没有设置，将返回 null。

2. List<CameraCharacteristics.Key<?>> getKeys()

获取该相机设备支持的 CameraCharacteristics.Key 的列表。
该方法获取的 Key 的列表，可以保证用作 CameraCharacteristics 类的 get() 方法时不会返回 null。
返回的 list 是不允许修改的，否则将抛出 UnsupportedOperationException 异常。

3. List<CaptureRequest.Key<?>> getAvailableCaptureRequestKeys()

获取该相机设备支持的 CaptureRequest.Key 的列表。可用于 CaptureRequest 类的 get() 方法。

4. List<CaptureResult.Key<?>> getAvailableCaptureResultKeys()

获取该相机设备支持的 CaptureResult.Key 的列表。可用于 CaptureResult 类的 get() 方法。

五、成员字段

这个太多了，差不多就是翻译一下官方文档了，这里一些常用的我就加粗表示吧。

对于一些缩写，你应该也需要了解，例如 自动曝光 AE（auto exposure）、自动聚焦 AF（auto focus）、自动白平衡 AWB（auto white balance） 等。

类型字段名描述
public static final Key<int[]>COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES相机设备支持的像差校正模式列表，用于 android.colorCorrection.aberrationMode
public static final Key<int[]>CONTROL_AE_AVAILABLE_ANTIBANDING_MODES相机设备支持的自动曝光反冲带模式列表，用于 android.control.aeAntibandingMode
public static final Key<int[]>CONTROL_AE_AVAILABLE_MODES相机设备支持的自动曝光模式列表，用于 android.control.aeMode
public static final Key<Range[]<Integer>>CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES相机设备支持的帧率范围，用于 android.control.aeTargetFpsRange
public static final Key<Range<Integer>>CONTROL_AE_COMPENSATION_RANGE相机设备支持的曝光补偿范围，用于 android.control.aeExposureCompensation
public static final Key<Rational>CONTROL_AE_COMPENSATION_STEP曝光补偿能够改变的最小步长
public static final Key<Boolean>CONTROL_AE_LOCK_AVAILABLE相机设备是否支持 android.control.aeLock
public static final Key<int[]>CONTROL_AF_AVAILABLE_MODES相机设备支持的自动聚焦模式列表，用于 android.control.afMode
public static final Key<int[]>CONTROL_AVAILABLE_EFFECTS相机设备支持的颜色效果列表，用于 android.control.effectMode
public static final Key<int[]>CONTROL_AVAILABLE_MODES相机设备支持的控制模式列表，用于 android.control.mode
public static final Key<int[]>CONTROL_AVAILABLE_SCENE_MODES相机设备支持的场景模式列表（如夜景、美食、烛光等），用于 android.control.sceneMode
public static final Key<int[]>CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES相机设备支持的视频稳定模式列表，用于 android.control.videoStabilizationMode
public static final Key<int[]>CONTROL_AWB_AVAILABLE_MODES相机设备支持的自动白平衡模式列表，用于 android.control.awbMode
public static final Key<Boolean>CONTROL_AWB_LOCK_AVAILABLE相机设备是否支持 android.control.awbLock
public static final Key<Integer>CONTROL_MAX_REGIONS_AE自动曝光可使用的最大测量区域数
public static final Key<Integer>CONTROL_MAX_REGIONS_AF自动聚焦可使用的最大测量区域数
public static final Key<Integer>CONTROL_MAX_REGIONS_AWB自动白平衡可使用的最大测量区域数
public static final Key<Range<Integer>>CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE相机设备支持的 boost 范围，用于 android.control.postRawSensitivityBoost
public static final Key<Boolean>DEPTH_DEPTH_IS_EXCLUSIVE指出一个捕捉请求是否能够同时支持深度输出（如 DEPTH16 / DEPTH_POINT_CLOUD）和普通颜色输出（如 YUV_420_888, JPEG 或 RAW）
public static final Key<int[]>DISTORTION_CORRECTION_AVAILABLE_MODES相机设备支持的畸变矫正模式列表，用于 android.distortionCorrection.mode
public static final Key<int[]>EDGE_AVAILABLE_EDGE_MODES相机设备支持的边缘增强模式列表，用于 android.edge.mode
public static final Key<Boolean>FLASH_INFO_AVAILABLE相机设备是否有闪光灯部件
public static final Key<int[]>HOT_PIXEL_AVAILABLE_HOT_PIXEL_MODES相机设备支持的像素矫正模式列表，用于 android.hotPixel.mode
public static final Key<Integer>INFO_SUPPORTED_HARDWARE_LEVEL相机设备支持的硬件等级
public static final Key<String>INFO_VERSION关于相机设备的制造商版本信息，例如网络服务硬件、传感器等
public static final Key<Size[]>JPEG_AVAILABLE_THUMBNAIL_SIZES相机设备支持的 JPEG 格式缩略图大小列表，用于 android.jpeg.thumbnailSize
public static final Key<float[]>LENS_DISTORTION矫正系数，以纠正相机设备的径向和切向的镜头畸变
public static final Key<Integer>LENS_FACING相机设备相对于屏幕的方向，例如后置摄像头一般是 LENS_FACING_FRONT
public static final Key<float[]>LENS_INFO_AVAILABLE_APERTURES相机设备支持的光圈大小列表，用于 android.lens.aperture
public static final Key<float[]>LENS_INFO_AVAILABLE_FILTER_DENSITIES相机设备支持的中性密度滤波值列表，用于 android.lens.filterDensity
public static final Key<float[]>LENS_INFO_AVAILABLE_FOCAL_LENGTHS相机设备支持的焦距列表，用于 android.lens.focalLength
public static final Key<int[]>LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION相机设备支持的光学稳像（optical image stabilization，OIS）模式列表，用于 android.lens.opticalStabilizationMode
public static final Key<Integer>LENS_INFO_FOCUS_DISTANCE_CALIBRATION镜头焦距校准质量
public static final Key<Float>LENS_INFO_HYPERFOCAL_DISTANCE镜头的超焦距
public static final Key<Float>LENS_INFO_MINIMUM_FOCUS_DISTANCE能使镜头聚焦的最短距离
public static final Key<float[]>LENS_INTRINSIC_CALIBRATION相机设备的内部标定参数（相机内参）
public static final Key<Integer>LENS_POSE_REFERENCE镜头的引用位置，即用于 android.lens.poseTranslation 的起始坐标
public static final Key<float[]>LENS_POSE_ROTATION相机设备相对于传感器坐标系的方向
public static final Key<float[]>LENS_POSE_TRANSLATION相机光学中心位置
public static final Key<float[]>LENS_RADIAL_DISTORTION镜头径向畸变，在 Android 28 上已弃用，使用 android.lens.distortion 代替
public static final Key<Integer>LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE物理相机间帧时间戳同步的准确性，决定了物理相机同时开始曝光的能力
public static final Key<int[]>NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES相机设备支持的降噪模式列表，用于 android.noiseReduction.mode
public static final Key<Integer>REPROCESS_MAX_CAPTURE_STALL重处理捕获请求时的最大失帧（以帧为单位）
public static final Key<int[]>REQUEST_AVAILABLE_CAPABILITIES相机设备完全支持的功能列表
public static final Key<Integer>REQUEST_MAX_NUM_INPUT_STREAMS相机设备能够同时支持的不同类型的输入流最大数量
public static final Key<Integer>REQUEST_MAX_NUM_OUTPUT_PROC相机设备能够同时支持的不同处理格式的输出流最大数量（无停顿）
public static final Key<Integer>REQUEST_MAX_NUM_OUTPUT_PROC_STALLING相机设备能够同时支持的不同处理格式的输出流最大数量（有停顿）
public static final Key<Integer>REQUEST_MAX_NUM_OUTPUT_RAW对于任何 RAW 格式，相机设备能够同时支持的不同类型的输出流最大数量
public static final Key<Integer>REQUEST_PARTIAL_RESULT_COUNT定义一个结果将由多少个子结构组成
public static final Key<Byte>REQUEST_PIPELINE_MAX_DEPTH指定一个帧从暴露到可使用，所经过的管道阶段数的最大值
public static final Key<Float>SCALER_AVAILABLE_MAX_DIGITAL_ZOOMactive 区域宽高和裁剪区域宽度比值的最大值，用于 android.scaler.cropRegion
public static final Key<Integer>SCALER_CROPPING_TYPE相机设备支持的裁剪类型，有 CENTER_ONLY 和 FREEFORM·两种
public static final Key<StreamConfigurationMap>SCALER_STREAM_CONFIGURATION_MAP相机设备支持的可用流的配置，包括最小帧间隔、不同格式、大小组合的失帧时长
public static final Key<int[]>SENSOR_AVAILABLE_TEST_PATTERN_MODES相机设备支持的测试模式列表，用于 android.sensor.testPatternMode
public static final Key<BlackLevelPattern>SENSOR_BLACK_LEVEL_PATTERN每个彩色滤光片排列(CFA)镶嵌通道的固定黑色电平偏移量
public static final Key<ColorSpaceTransform>SENSOR_CALIBRATION_TRANSFORM1从参考传感器颜色空间映射到实际设备传感器颜色空间的每个设备校准转换矩阵
public static final Key<ColorSpaceTransform>SENSOR_CALIBRATION_TRANSFORM2从参考传感器颜色空间映射到实际设备传感器颜色空间(这是原始缓冲区数据的颜色空间)的每个设备校准转换矩阵
public static final Key<ColorSpaceTransform>SENSOR_COLOR_TRANSFORM1将颜色值从CIE XYZ颜色空间转换为参考传感器颜色空间的矩阵
public static final Key<ColorSpaceTransform>SENSOR_COLOR_TRANSFORM2将颜色值从CIE XYZ颜色空间转换为参考传感器颜色空间的矩阵
public static final Key<ColorSpaceTransform>SENSOR_FORWARD_MATRIX1一个矩阵，将白平衡摄像机颜色从参考传感器颜色空间转换为带有D50白点的CIE XYZ颜色空间
public static final Key<ColorSpaceTransform>SENSOR_FORWARD_MATRIX2一个矩阵，将白平衡摄像机颜色从参考传感器颜色空间转换为带有D50白点的CIE XYZ颜色空间
public static final Key<Rect>SENSOR_INFO_ACTIVE_ARRAY_SIZE经过几何畸变校正后，图像传感器对应于活动像素的面积
public static final Key<Integer>SENSOR_INFO_COLOR_FILTER_ARRANGEMENT传感器上颜色滤波器的排列，按读取顺序，表示传感器左上2x2部分的颜色
public static final Key<Range<Long>>SENSOR_INFO_EXPOSURE_TIME_RANGE相机设备支持的图片曝光时间范围，用于 android.sensor.exposureTime
public static final Key<Boolean>SENSOR_INFO_LENS_SHADING_APPLIED相机设备输出的原始图像是否受镜头阴影校正影响
public static final Key<Long>SENSOR_INFO_MAX_FRAME_DURATION相机设备支持的最大的帧间隔时间，用于 android.sensor.frameDuration
public static final Key<SizeF>SENSOR_INFO_PHYSICAL_SIZE完整像素数列的物理尺寸
public static final Key<Size>SENSOR_INFO_PIXEL_ARRAY_SIZE完整像素数列的尺寸，可能包括黑色校准像素
public static final Key<Rect>SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE在应用任何几何畸变校正之前，与活动像素相对应的图像传感器的面积
public static final Key<Range<Integer>>SENSOR_INFO_SENSITIVITY_RANGE相机设备支持的敏感度范围，用于 android.sensor.sensitivity
public static final Key<Integer>SENSOR_INFO_TIMESTAMP_SOURCE传感器开始捕捉的时间戳的时间基础
public static final Key<Integer>SENSOR_INFO_WHITE_LEVEL传感器最大的 raw 值输出
public static final Key<Integer>SENSOR_MAX_ANALOG_SENSITIVITY纯粹通过模拟增益实现的最大敏感度
public static final Key<Rect[]>SENSOR_OPTICAL_BLACK_REGIONS表示传感器光学屏蔽的黑色像素区域的不相交矩形列表
public static final Key<Integer>SENSOR_ORIENTATION使输出图像在设备屏幕上以本机方向垂直，顺时针方向旋转的角度
public static final Key<Integer>SENSOR_REFERENCE_ILLUMINANT1当计算 android.sensor.colorTransform1, android.sensor.calibrationTransform1 和 android.sensor.forwardMatrix1 矩阵时，作为场景光源的标准参考光源
public static final Key<Byte>SENSOR_REFERENCE_ILLUMINANT2当计算 android.sensor.colorTransform2, android.sensor.calibrationTransform2 和 android.sensor.forwardMatrix2 矩阵时，作为场景光源的标准参考光源
public static final Key<int[]>SHADING_AVAILABLE_MODES相机设备支持的镜头应用模式列表，用于 android.shading.mode
public static final Key<int[]>STATISTICS_INFO_AVAILABLE_FACE_DETECT_MODES相机设备支持的人脸检测模式列表，用于 android.statistics.faceDetectMode
public static final Key<boolean[]>STATISTICS_INFO_AVAILABLE_HOT_PIXEL_MAP_MODES相机设备支持的热像素映射输出模式列表，用于 android.statistics.hotPixelMapMode
public static final Key<int[]>STATISTICS_INFO_AVAILABLE_LENS_SHADING_MAP_MODES相机设备支持的镜头阴影映射输出模式列表，用于 android.statistics.lensShadingMapMode
public static final Key<int[]>STATISTICS_INFO_AVAILABLE_OIS_DATA_MODES相机设备支持的 OIS 数据输出模式列表，用于 android.statistics.lensShadingMapMode
public static final Key<Integer>STATISTICS_INFO_MAX_FACE_COUNT同时能够检测的人脸数的最大值
public static final Key<Integer>SYNC_MAX_LATENCY请求(与前一个请求不同)提交后以及结果状态同步之前可能出现的最大帧数
public static final Key<int[]>TONEMAP_AVAILABLE_TONE_MAP_MODES相机设备支持的图像增强映射模式列表，用于 android.tonemap.mode
public static final Key<Integer>TONEMAP_MAX_CURVE_POINTS图像增强映射曲线支持的最大点的数量，用于 android.tonemap.curve
 类似资料：

相关阅读

android之BroadcastReceiver应用详解SpringCloud之Feign示例详解Linux之split命令详解python之import机制详解PHP7内核之Reference详解

相关文章

居然之家二，详细面试题解析消息中间件 RabbitMQ 之 延迟队列 详解&实战消息中间件 RabbitMQ 之 交换机类型及其详解AQS详解AQS详解

相关问答

Java详细类加载骗子之谜骑士之旅使用Gradle在Java之前/之后编译ScalaAWS Kinesis流详细回顾

相关文档

Laravel 源码详解HAProxy 用法详解Android Animation 动画详解结构之法算法之道Python 初级教程：入门详解
快捷导航： 新手教程 算法原理 架构设计 Java进阶 数据库进阶 大厂专栏 面试经验 编程笔记 编程问答 所有专题 文档资料 工具软件 电子书籍 小牛导航
在线工具： 房贷计算器 个税计算器 Linux命令查询 Json格式化 正则表达式 颜色转换 AES加解密 SHA1加密 MD5加密 毒鸡汤 字数统计 随机密码生成 进制转换 Base64编解码 励志句子
Copyright © 2019-2024 小牛知识库@xnip.cn. All Rights Reserved.