Android Camera2 之 CameraCharacteristics 详解

news/2024/11/15 7:23:08/

一、简介

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

http://www.ppmy.cn/news/911073.html

相关文章

AE学习02：时间轴

AE学习02：时间轴

时间轴学习目录 1.视频剪辑 2.时间轴伸缩 3.冻结帧 4.缓动曲线 本文主要内容为在项目中比较实用的一些操作。 一.视频剪辑 1.快捷键 cmdshiftd&#xff0c;将会把合成剪切成两段&#xff0c;从当前帧处断开&#xff0c;分列在上下两行。 option/alt【 是剪去当前帧的前一部…
阅读更多...
密码学系列之:1Password的加密基础PBKDF2

密码学系列之:1Password的加密基础PBKDF2

文章目录 简介PBKDF2和PBKDF1PBKDF2的工作流程详解PBKDF2的key生成流程HMAC密码碰撞PBKDF2的缺点总结 简介 1password是一个非常优秀的密码管理软件&#xff0c;有了它你可以轻松对你的密码进行管理&#xff0c;从而不用再考虑密码泄露的问题&#xff0c;据1password官方介绍&…
阅读更多...
AE圣诞树(html版本)，免费

AE圣诞树(html版本)，免费

最近网上很火的AE圣诞树&#xff0c;这里免费提供给大家HTML版本 源码和视频下载&#xff1a;https://download.csdn.net/download/qq_56088882/87260627
阅读更多...
AE锚点居中设置

AE锚点居中设置

1、创建图形锚点快速居中可使用快捷键 CtrlAltHome 快速图形居中快捷键&#xff1a;CtrlHome 2、创建图形锚点自动居中&#xff0c;可在AE 首选项 中勾选 在新形状图层上居中放置锚点 2.1 编辑->搜选项->常规 或 使用 快捷键 CtrlAlt; 2.2 打钩 在新形状图层上居中放…
阅读更多...
AEJoy —— 彻底搞懂 AE 各种 loop* 表达式【一】

AEJoy —— 彻底搞懂 AE 各种 loop* 表达式【一】

前言 通过阅读本文&#xff0c;您将收获以下知识点 loopIn(type, numKeyframes) loopOut(type, numKeyframes) loopInDuration(type, duration) loopOutDuration(type, duration) 以及它们各自在不同 type 和 numKeyframes / duration 下的区别&#xff1b; 本文默认您已经…
阅读更多...
ae使用计算机不支持的文字,AE软件使用字体出现错误83 ::2如何解决？

ae使用计算机不支持的文字,AE软件使用字体出现错误83 ::2如何解决？

终极解决办法&#xff1a; 或者 选择了AE不能支持的中文字体&#xff0c;没有通用的ascii编码。 83 :: 2报错提示信息&#xff1a;After Effects error: CT generic : bad lenDesignVector 报错信息说明&#xff1a;对一个矢量图形素材的操作失败了。 报错的可能原因&#xff1…
阅读更多...
17.Java反射

17.Java反射

# 反射的简介 反射机制允许程序在执行期借助于 反射Api 取得任何类的内部信息&#xff0c;并能直接操作任意对象的内部属性及方法。 加载完类之后&#xff0c;在堆内存的方法区中就产生了一个 Class 类型的对象&#xff08;一个类只有一个 Class 对象&#xff09;&#xff0c;这…
阅读更多...
入门力扣自学笔记273 C++ （题目编号：979）

入门力扣自学笔记273 C++ （题目编号：979）

979. 在二叉树中分配硬币 题目&#xff1a; 给定一个有 N 个结点的二叉树的根结点 root&#xff0c;树中的每个结点上都对应有 node.val 枚硬币&#xff0c;并且总共有 N 枚硬币。 在一次移动中&#xff0c;我们可以选择两个相邻的结点&#xff0c;然后将一枚硬币从其中一个…
阅读更多...
最新文章

Copyright @ 2022~2023