Android基础总结： Camera2详解之一 API学习
Camera2的API出来有些年头了，只是赶项目多次使用，没时间好好总结，年终了，正好结合google的官方Camera2demo 和开发中使用的情况，做个详细梳理，研究总结之后，才发现Camera2并非想象的难用，充分理解相关几个类之后，实现自己需求还是很简单的。
该篇详细介绍Camera2相关的类，根据API各个类的方法，字段含义都详细用表格记录。
下一篇将介绍Camera2的使用流程。
<一>SurfaceView 相关的类
在Camera的时候，自定义相机预览首选 SurfaceView当展示布局，更深层的结合openCV openGL库的GLSurfaceView，做渲染滤镜游戏动画等。首先了解相关类SurfaceView和SurfaceHolder的API。
<1>SurfaceView API
当SurfaceView窗口可见时，就可以创建这个表面，当urfaceView展示或者隐藏时，需要对它进行创建和销毁，你就需要实现SurfaceViewCreated(SurfaceHolder)方法或者SurfaceViewDestroyed(SurfaceHolder）方法。
这个类的用途之一就是提供了一个可以在屏幕上显示辅助线程的Surface，要使用，需要了解线程语义：回调方法Callback将从运行的SurfceView窗口调用，所以需要正确的同步绘制线程。在SurfaceHolder.Callback.surfaceCreated() 方法和 SurfaceHolder.Callback.surfaceDestroyed()方法之间是有效的期间，你必须确保绘图线程只和使用的SurfaceView有联系。
注意:从android7.0开始，SurfaceView的窗口位置与其他视图呈现同步更新。这意味着在屏幕上平移和缩放一个SurfaceView将不会导致呈现工件
| public方法 | 解释 |
|---|---|
| void draw(Canvas canvas) | 手动的将各种view渲染到给定的画布上 |
| boolean gatherTransparentRegion(Region region) | 当视图层次结构包含一个或多个SurfaceView时，RootView使用它来执行优化。 |
| SurfaceHolder getHolder() | 返回SurfaceHolder，用于访问和控制SurfaceView |
| void setSecure(boolean isSecure) | 控制表面视图的内容是否应该被视为安全的，防止它出现在屏幕截图中或在非安全显示中被查看。注意，必须在窗口管理器的窗口视图包含窗口之前设置此设置。 |
| void setVisibility(int visibility) | surfaceView可见设置 |
| void setZOrderMediaOverlay(boolean isMediaOverlay) | surfaceView1是否被放置在另一个surfaceView2视图上 |
| setZOrderOnTop(boolean onTop) | 在自己的window内，设置最顶层显示 |
protected的方法
| protected方法 | 解释 |
|---|---|
| void dispatchDraw(Canvas canvas) | 由draw调用绘制子view |
| void onAttachedToWindow() | 视图view依附到window上被触发 |
| void onDetachedFromWindow() | 视图view从window上分离被触发 |
| onMeasure(int widthMeasureSpec, int heightMeasureSpec) | 绘制view的宽高 |
| onWindowVisibilityChanged(int visibility) | 在视图持续可见和不可见变化时触发 |
<2> SurfaceHolder API
| 返回值（abstract） | 方法 | 解释 |
|---|---|---|
| void | addCallback(SurfaceHolder.Callback callback) | 为整个holder添加回调接口 |
| Surface | getSurface() | 直接访问surface对象 |
| Rect | getSurfaceFrame() | 获取surface的尺寸大小 |
| boolean | isCreating() | 使用这个方法来找出是否在从回调方法创建的过程中。 |
| Canvas | lockCanvas() | 开始编辑surface的像素 |
| void | unlockCanvasAndPost(Canvas canvas) | 结束编辑surface像素 |
| Canvas | lockCanvas(Rect dirty) | 开始编辑surface的像素，但是允许特殊矩形 |
| default Canvas | lockHardwareCanvas() | 开始编辑surface的像素，但是返回的画布是硬件加速的 |
| void | removeCallback(SurfaceHolder.Callback callback) | 从holder移除回调接口 |
| void | setFixedSize(int width, int height) | 修改surface 尺寸 |
| void | setFormat(int format) | 设置surface的像素格式 格式：PixelFormat |
| abstract void | setKeepScreenOn(boolean screenOn) | 启用或禁用选项，以便在显示该界面时打开屏幕。 |
| void | setSizeFromLayout() | 允许Surface根据其容器的布局调整大小 |
<3> SurfaceHolder.Callback接口
| 重写方法 | 解释 |
|---|---|
| surfaceChanged(SurfaceHolder holder, int format, int width, int height) | surface改变回调 |
| surfaceCreated(SurfaceHolder holder) | surface第一次创建就回调 |
| surfaceDestroyed(SurfaceHolder holder) | surface销毁回调 |
<二>Camera2 相关的类
android5.0之后支持的API，主要功能都在android.hardware.camera2中。相关的类有：
1：CameraManager(以及两个回调 AvailabilityCallback和TorchCallback)
2：CameraDevice(以及回调StateCallback)
3：CameraCaptureSession(以及两个回调：CaptureCallback和StateCallback)
4：CaptureRequest(以及CaptureRequest.Builder类)+CaptureResult+TotalCaptureResult+CameraCharacteristics，这四个类都继承了基类CameraMetadata
5：接收数据类android.media.ImageReader
6：xml布局类：TextureView (google demo推荐)或SurfaceView
<1>CameraManager
官方文档解释：
一种系统服务管理器，用于检测、描述和连接到照相机设备。
获取该实例的方法:CameraManager manager =（CameraManager）Context.getSystemService(Context.CAMERA_SERVICE);或者
CameraManager manager =（CameraManager）Context. getSystemService(CameraManager.class);
| 返回值 | 方法名 | 解释 |
|---|---|---|
| CameraCharacteristics | getCameraCharacteristics(String cameraId) | 查询摄像机设备的功能。 |
| String[] | getCameraIdList() | 通过标识符返回当前连接的相机设备的列表，包括可能被其他相机API客户端使用的相机。 |
| openCamera(String cameraId, CameraDevice.StateCallback callback, Handler handler) | 打开一个带有给定ID的相机的连接。 | |
| registerAvailabilityCallback(CameraManager.AvailabilityCallback callback, Handler handler) | 注册一个回调，以获得关于相机设备可用性的通知。 | |
| registerTorchCallback(CameraManager.TorchCallback callback, Handler handler) | 注册一个回调，以获得关于torch mode状态的通知。 | |
| setTorchMode(String cameraId, boolean enabled) | 在不打开相机设备的情况下，设置闪光灯的闪光灯模式。 | |
| unregisterAvailabilityCallback(CameraManager.AvailabilityCallback callback) | 删除之前添加的回调，回调将不再接收连接和断开回调。 | |
| unregisterTorchCallback(CameraManager.TorchCallback callback) | 删除之前添加的回调，回调将不再接收torch mode状态回调。 |
<1-1>CameraManager.AvailabilityCallback
CameraManager的内部类AvailabilityCallback回调，官方文档解释：
一个用于相机设备的回调或无法打开的回调。
当相机不再使用时，或者当一个新的可拆卸相机连接起来时，Cameras就会变的可用了。
当一些应用程序或服务开始使用相机时，或者当一个可移动的相机被断开时，它们就变得不可用了。
扩展这个回调并将子类的实例传递给CameraManager的registerAvailabilityCallback(CameraManager.AvailabilityCallback, Handler) 方法通知这些可用性更改。
| 回调方法名 | 解释 |
|---|---|
| onCameraAvailable(String cameraId) | 一个新的相机已经可以使用了。 |
| onCameraUnavailable(String cameraId) | 以前可用的相机已经不可用了。 |
<1-2>CameraManager.TorchCallback
CameraManager的内部类TorchCallback回调，官方文档解释：
一个相机闪光灯torch模式变得可用不可用的回调。
当相机设备所属的相机设备变得不可用或其他相机资源时，由于其他更高的优先级相机活动， torch mode就变得不可用。当它被关闭时，或者当它所属的相机设备不再使用，它所需要的其他相机资源不再忙碌时，torch mode就会不可用。当应用程序调用CameraManager的setTorchMode(String, boolean)关闭相机的torch mode，或者当应用程序打开其他相机的torch mode，，如果同时不支持多个火炬模式，相机的torch mode就会被关闭。当通过setTorchMode(String, boolean)打开torch mode时，torch mode就会可用。
只有当处于禁用或启用状态时，才可以通过setTorchMode(String、boolean)设置torch mode。
扩展这个回调并将一个子类的实例传递给CameraManager的registerTorchCallback(CameraManager.TorchCallback, Handler)将被通知此类状态更改。
| 回调方法名 | 解释 |
|---|---|
| onTorchModeChanged(String cameraId, boolean enabled) | setTorchMode(String, boolean)触发 |
| onTorchModeUnavailable(String cameraId) | setTorchMode(String, boolean)触发 |
<2>CameraDevice
官方文档详解：
CameraDevice 类是一个连接安卓设备的单一摄像头的代表，可以在高帧率下对图像捕捉和后期处理进行精确控制。
你的应用程序需要在manifest中生命相机权限才可以访问相机设备。
一个给定的相机设备可以提供两个级别的支持:有限的或完全的。如果一个设备只支持有限的级别，那么摄像头会公开一个功能集，它大致相当于旧的摄像头API，不过它的界面更简洁、更高效。如果是全支持，提供了比旧的摄像头API更好的功能。针对有限级别设备的应用程序将在全级设备上保持不变，而如果应用程序需要一个全级别支持的操作,在manifest中声明“android.hardware.camera.level.full”的特征。
该类的常量：
| 常量名 | 解释 |
|---|---|
| TEMPLATE_MANUAL | 一个用于直接应用控制捕获参数的基本模板。 |
| TEMPLATE_PREVIEW | 创建一个适合于相机预览窗口的请求。 |
| TEMPLATE_RECORD | 创建一个适合于视频录制的请求。 |
| TEMPLATE_STILL_CAPTURE | 创建一个适合于静态图像捕获的请求。 |
| TEMPLATE_ZERO_SHUTTER_LAG | 创建一个适用于零快门延迟的请求。 |
| TEMPLATE_VIDEO_SNAPSHOT | 在录制视频时创建一个适合静态图像捕捉的请求。 |
该常量一般在CameraDevice的createCaptureRequest(int)方法参数中设置。
该类的方法：
| 返回值 | 方法名 | 解释 |
|---|---|---|
| void | close() | 尽可能快地关闭与这个相机设备的连接。 |
| CaptureRequest.Builder | createCaptureRequest(int templateType) | 创建一个CaptureRequest.Builder用于新捕获请求的，初始化为目标用例的模板。 |
| void | createCaptureSession(List Surface outputs, CameraCaptureSession.StateCallback callback, Handler handler) | 通过向相机设备提供Surfaces的目标输出集，创建一个新的相机捕捉会话。 |
| void | createCaptureSessionByOutputConfigurations(List OutputConfiguration outputConfigurations, CameraCaptureSession.StateCallback callback, Handler handler) | 通过为相机设备提供表面的目标输出集和相应的表面配置来创建一个新的相机捕捉会话。 |
| void | createConstrainedHighSpeedCaptureSession(List Surface outputs, CameraCaptureSession.StateCallback callback, Handler handler) | 创建一个新的受限的高速捕捉会话。 |
| String | getId() | 获取相机设备的ID，string类型 |
CameraDevice还一个方法,就不写在表格中了：
createReprocessableCaptureSessionByConfigurations(InputConfiguration , outputs, CameraCaptureSession.StateCallback, Handler) ,通过为相机设备提供所需的再处理输入配置和输出输出配置，创建一个新的可重新处理的相机捕捉会话。
<2-1>CameraDevice.StateCallback
CameraDevice的内部类StateCallback，官方文档介绍：
一个回到对象，用于接收关于相机的更新状态。
一个回调实例必须先实现CameraManager的openCamera(String cameraId, CameraDevice.StateCallback callback, Handler handler) 方法来打开相机设备。
这些状态更新包括关于设备完成启动的通知(允许CameraDevice的createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)被调用），关于设备断开或闭包，以及意外的设备错误。
关于特定的CaptureRequests进程事件是由 CameraCaptureSession.CaptureCallback 提供的，该回调的所有方法见上边表格。
常量及方法：
| 返回值 | 常量 | 解释 |
|---|---|---|
| int | ERROR_CAMERA_DEVICE | 由CameraDevice.StateCallback的onError(CameraDevice, int)报告的错误代码，表明相机设备遇到了一个致命错误 |
| int | ERROR_CAMERA_DISABLED | 由CameraDevice.StateCallback的onError(CameraDevice, int)报告的错误代码，这表明由于设备的政策，相机设备无法打开。 |
| int | ERROR_CAMERA_IN_USE | 由onError(CameraDevice, int)报告的错误代码，表明摄像机设备已经在使用中了 |
| int | ERROR_CAMERA_SERVICE | 由onError(CameraDevice, int)报告的错误代码，表明摄像机服务遇到了一个致命错误。 |
| int | ERROR_MAX_CAMERAS_IN_USE | 由onError(CameraDevice, int)报告的错误代码，表明相机设备无法打开，因为有太多其他的开放相机设备。 |
| 回调方法 | 解释 |
|---|---|
| onClosed(CameraDevice camera) | 当一个相机设备CameraDevice的close()方法时，这个方法就被调用 |
| onDisconnected(CameraDevice camera) | 当相机设备不再可用时，这个方法就被调用 |
| onError(CameraDevice camera, int error) | 当相机设备遇到严重错误时，这种方法就被调用了，错误见上表的常量 |
| onOpened(CameraDevice camera) | 当相机完成打开操作后，这个方法就被调用 |
<3>CameraCaptureSession
文档解释：
CameraDevice类的一个配置捕捉会话，用于捕捉相机的照片，或者用于之前同一个会话中处理相机捕捉的图片。
提供一组目标输出表面给 CameraDevice的createCaptureSession()方法，或者提供一 个InputConfiguration类和为了一个可加工捕捉会话提供一组目标输出表面给CameraDevice的createReprocessableCaptureSession()方法，就会创建CameraCaptureSession对象，一旦创建CameraCaptureSession，这个会话就处于活动状态，除非相机又新建一个会话或者设备关闭。
所有的捕捉会话都可用于从相机捕捉照片，但是只有可加工捕捉会话在之前同一个会话中可以处理从相机捕捉的照片。
创建一个会话是个昂贵的操作，可以花费零点几秒时间，因为它需要配置摄像机设备的内部管道( pipelines),并分配内存缓冲区，以便将图像发送到所需的目标。因此设置异步操作, CameraDevice的createCaptureSession和createReprocessableCaptureSession方法会将创建出的CameraCaptureSession对象发送给CameraCaptureSession.StateCallback的onConfigured 回调方法，如果配置不能完成，就会回调 onConfigureFailed方法，会话就不能被激活。
如果一个新的会话被相机创建，name之前的会话就会被关闭，他的关联回调CameraCaptureSession.StateCallback的onClosed方法就会被调用，如果会话被关闭，所有会话方法都将抛出IllegalStateException异常。
一个关闭的会话会清除所有重复的操作（就像调用CameraCaptureSession的stopRepeating()方法），但是，在新建的会话接管并配置相机前，仍然像正常一样完成所有的进程捕捉请求。
| 返回值 | 方法 | 解释 |
|---|---|---|
| abortCaptures() | 丢弃当前正在等待和正在进行中的所有捕获，并尽可能快地完成。 | |
| int | capture(CaptureRequest request, CameraCaptureSession.CaptureCallback listener, Handler handler) | 提交一个图像请求，以便被摄像机设备捕捉到。 |
| int | captureBurst(List requests, CameraCaptureSession.CaptureCallback listener, Handler handler) | 提交一列作为突发事件被捕获的请求列表。 |
| close() | 异步关闭这个捕获会话。 | |
| finalizeOutputConfigurations(List outputConfigs) | 最后确定输出配置，这些配置现在包含了它们的延迟和/或额外的表面。 | |
| CameraDevice | getDevice() | 获取这个会话创建的摄像机设备。 |
| Surface | getInputSurface() | 获取与可重新处理的捕获会话相关的输入表面。 |
| boolean | isReprocessable() | 如果应用程序可以使用这个摄像机捕捉会话提交可处理的捕获请求，则返回true。 |
| prepare(Surface surface) | 预先为输出Surface分配所有缓冲区。 | |
| int | setRepeatingBurst(List requests, CameraCaptureSession.CaptureCallback listener, Handler handler) | 这个捕获会话请求不断地重复捕获一系列图像。 |
| setRepeatingRequest(CaptureRequest request, CameraCaptureSession.CaptureCallback listener, Handler handler) | 请求不断地重复捕捉这个捕获会话的图像。 | |
| stopRepeating() | 取消上边两个方法中任意一个的重复捕捉请求 |
<3-1>CameraCaptureSession.CaptureCallback
CameraCaptureSession的内部类CaptureCallback，官方文档解释：
一个回调对象，用于跟踪向相机提交CaptureRequest对象的进程，见下边的CameraDevice.StateCallback的文档解释。
这个回调是在一个请求触发一个捕获开始时调用的，当捕获完成时调用。如果出现错误捕获图像，则会触发错误方法，而不是完成方法。
重写的七个方法：
| 方法 | 解释 |
|---|---|
| onCaptureBufferLost(CameraCaptureSession session, CaptureRequest request, Surface target, long frameNumber) | 如果捕获的单个缓冲区不能发送到它的目标表面，就会调用该方法。 |
| onCaptureCompleted(CameraCaptureSession session, CaptureRequest request, TotalCaptureResult result) | 当一个图像捕捉已经完全完成并且所有的结果元数据都可用时，这个方法就会被调用。 |
| onCaptureFailed(CameraCaptureSession session, CaptureRequest request, CaptureFailure failure) | 当相机不能向 CaptureResult 对象提供请求，就会调用 |
| onCaptureProgressed(CameraCaptureSession session, CaptureRequest request, CaptureResult partialResult) | 当图像捕捉取得部分进展时，就会调用该方法;有些(但不是全部)从图像捕获中得到的结果是可用的。 |
| onCaptureSequenceAborted(CameraCaptureSession session, int sequenceId) | 这个方法独立于CaptureCallback中的其他方法，当捕获序列在任何CaptureResult或capture失败之前通过这个侦听器返回时。 |
| onCaptureSequenceCompleted(CameraCaptureSession session, int sequenceId, long frameNumber) | 这个方法独立于CaptureCallback中的其他方法，当捕获序列完成后，通过这个侦听器返回所有的CaptureResult或capture失败。 |
| onCaptureStarted(CameraCaptureSession session, CaptureRequest request, long timestamp, long frameNumber) | 当摄像机设备开始捕捉请求的输出图像，在图像曝光开始时，或者当摄像机设备开始处理一个重新处理请求的输入图像时，这个方法就被调用了。 |
<3-2>CameraCaptureSession.StateCallback
CameraCaptureSession的内部类StateCallback，一个回调对象，用于接收关于相机捕捉会话状态的更新。
重写的七个方法：
| 方法 | 解释 |
|---|---|
| onActive(CameraCaptureSession session) | 当会话开始主动处理捕获请求时，将调用此方法。 |
| onCaptureQueueEmpty(CameraCaptureSession session) | 当摄像机设备的输入捕捉队列变为空时，该方法将被调用，并准备接受下一个请求。 |
| onClosed(CameraCaptureSession session) | 会话关闭触发 |
| onConfigureFailed(CameraCaptureSession session) | 如果会话不能按照请求配置，则调用此方法。 |
| onConfigured(CameraCaptureSession session) | 当摄像机设备完成配置时，这个方法就会被调用，会话可以开始处理捕获请求。 |
| onReady(CameraCaptureSession session) | 每当会话不再需要处理请求时，就会调用此方法。 |
| onSurfacePrepared(CameraCaptureSession session, Surface surface) | 当输出表的缓冲区预分配完成时，就会调用该方法。 |
<4>CaptureRequest，CameraCharacteristics,TotalCaptureResult和CaptureResult四个类的区别
这四个类放在一起，是因为他们有共同的字段列表，都继承于CameraMetadata，具体的关系如下:
1: CaptureRequest extendsCameraMetadata implements Parcelable
2:CameraCharacteristics extends CameraMetadata
3:TotalCaptureResult extends CaptureResult CameraMetadata
4:CameraMetadata比较单一，放在下边一节的表格中显示。
四个类文档解释
<1>CaptureRequest 官方文档解释：
一个不可变的设置和输出，用来从相机设备捕捉单个图像。
包含捕获硬件的配置(传感器sensor,、透镜 lens、闪光灯flash)，处理管道pipeline，控制算法和输出缓冲区。还包含目标表面的列表，以便将图像数据发送给该捕获。
使用CaptureRequest.Builder实例创建CaptureRequests对象，通过调用CameraDevice的createCaptureRequest(int templateType) 获取CaptureRequest.Builder对象。
CaptureRequest对象调用CameraCaptureSession的capture(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler)或者setRepeatingRequest(CaptureRequest, CameraCaptureSession.CaptureCallback, Handler) 方法从相机捕捉照片。
每个请求都可以指定目标表面的不同子集，以便将捕获的数据发送到。当请求被提交到会话时，请求中使用的所有表面都必须是对方法 createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)的最后一次调用所给出的地表列表的一部分（ All the surfaces used in a request must be part of the surface list given to the last call to createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)， when the request is submitted to the session）
例如，一个用于重复预览的请求可能只包含预览SurfaceView或SurfaceTexture的表面，而高分辨率的静态捕获还包括一个用于高分辨率JPEG图像的ImageReader的表面。
可处理捕获请求允许从摄像机设备获取以前捕获的图像，并将其发送回设备进行进一步处理。 会话用CameraDevice的createReprocessCaptureRequest(TotalCaptureResult)创建，可修理拍照会话用CameraDevice的createReprocessableCaptureSession(InputConfiguration, List, CameraCaptureSession.StateCallback, Handler)创建.
<2>CameraCharacteristics官方文档解释：
描述摄像头设备的属性。
这些属性是给定的摄像头的属性，可以通过CameraManager的getCameraCharacteristics(String cameraId) 方法获取单个摄像头的CameraCharacteristics对象（个人观点：通过该对象可以判断摄像头都支持什么功能，比如闪光灯，方向等等）。
CameraCharacteristics对象是不可变的。
<3>TotalCaptureResult官方文档解释：
从图像传感器捕捉到的单个图像捕获的全部结果。
包含捕获硬件的配置(传感器sensor,、透镜 lens、闪光灯flash)，处理管道pipeline，控制算法和输出缓冲区。
处理完 CaptureRequest之后，TotalCaptureResult由CameraDevice类产生。所有捕获请求的属性列表都可以在捕获结果中查询到 ，以确定用于捕获的最终的值。结果还包括在捕捉期间相机设备状态的附加元数据。
getAvailableCaptureResultKeys()返回的所有属性是可用的(这是get(CaptureResult.Key)方法将返回非空值,当且仅当启用的关键要求）。除非启用了一个开关(如STATISTICS_FACE_DETECT_MODE)，否则在默认情况下，一些关键字将被禁用。请参考每个关键文档的具体情况。
TotalCaptureResult对象是不可变的。
<4>CaptureResult官方文档解释：
从图像传感器捕获单个图像的结果子集。
包含捕获硬件的配置(传感器sensor,、透镜 lens、闪光灯flash)，处理管道pipeline，控制算法和输出缓冲区。
处理完 CaptureRequest之后，CaptureResults由CameraDevice类产生。所有捕获请求的属性列表都可以在捕获结果中查询到，以确定用于捕获的最终的值。结果还包括在捕捉期间相机设备状态的附加元数据。
不是所有属性调用CameraCharacteristics的getAvailableCaptureResultKeys()返回必然是可用的。一些结果是局部的(CaptureResult)，并且不会有每一个键集。只有TotalCaptureResult被保证拥有由请求启用的所有可用的键。
CaptureResult对象是不可变的。
四个类各自独有的方法和字段
<1>CaptureRequest
| 返回值 | 方法 | 解释 |
|---|---|---|
| int | describeContents() | 描述这个可分配实例的集合表示中包含的特殊对象的种类。 |
| boolean | equals(Object other) | 确定这个CaptureRequest是否等于另一个CaptureRequest。 |
| T | get(Key key) | 获取捕获请求字段值。 |
| Object | getTag() | |
| List> | getKeys() | 返回该map中包含的键列表。 |
| int | hashCode() | |
| boolean | isReprocess() | 确定这是不是一个可加工的捕获请求。 |
| writeToParcel(Parcel dest, int flags) | 把这个物体拉到一个包裹里。 |
CaptureRequest和CaptureResult的父类字段，以及所有各自的字段都是相同的
| 返回值(public static final ) | 字段名 | 解释 |
|---|---|---|
| Key Boolean | BLACK_LEVEL_LOCK | 黑等级的补偿是否被锁定在当前的值上，或者是自由的变化。 |
| Key Integer | COLOR_CORRECTION_ABERRATION_MODE | 色差 |
| Key RggbChannelVector | COLOR_CORRECTION_GAINS | 获得白平衡Bayer的raw color频道 |
| Key Integer | COLOR_CORRECTION_MODE | 模式控制选择如何将图像数据从传感器的本机颜色转换为线性sRGB颜色。 |
| Key ColorSpaceTransform | COLOR_CORRECTION_TRANSFORM | 一种颜色变换矩阵，用于从传感器RGB颜色空间转换为输出线性sRGB色彩空间 |
| Key Integer | CONTROL_AE_ANTIBANDING_MODE | 相机设备的自动曝光算法的反带补偿的理想设置。 |
| Key Integer | CONTROL_AE_EXPOSURE_COMPENSATION | 调整自动曝光(AE)目标图像亮度。 |
| Key Integer | CONTROL_AE_LOCK | 是否自动曝光(AE)目前被锁定在最新的计算值上。 |
| Key Integer | CONTROL_AE_MODE | 相机设备的自动曝光程序所需的模式。 |
| Key Integer | CONTROL_AE_PRECAPTURE_TRIGGER | 当它处理这个请求时，摄像机设备是否会触发一个预捕获的测量序列。 |
| Key MeteringRectangle[] | CONTROL_AE_REGIONS | 用于自动曝光调整的计量区域表。 |
| Key Boolean | CONTROL_AWB_LOCK | 自动白平衡(AWB)是否被锁定在最新的计算值上。 |
| Key Integer | CONTROL_AWB_MODE | 自动白平衡(AWB)是否正在设置颜色转换字段，以及它的照明目标是什么。 |
| Key MeteringRectangle[] | CONTROL_AWB_REGIONS | 用于自动平衡光源估计的计量区域的列表。 |
| Key Integer | CONTROL_CAPTURE_INTENT | 信息到相机设备3A(自动曝光，自动对焦，自动平衡)例程，以帮助相机设备决定最优的3A策略。 |
| Key Integer | CONTROL_EFFECT_MODE | 一种特殊的颜色效果。 |
| Key Boolean | CONTROL_ENABLE_ZSL | 允许相机设备为android.control.captureIntent == STILL_CAPTURE 的请求启用零树/延迟模式 |
| Key Integer | CONTROL_MODE | 3A的整体模式(自动曝光，自动平衡，自动对焦)控制例程。 |
| Key Integer | CONTROL_POST_RAW_SENSITIVITY_BOOST | 在获取原始传感器数据后，应用于输出图像的额外灵敏度增加。 |
| Key Integer | CONTROL_SCENE_MODE | 控制哪个场景模式当前是活跃的。 |
| Key Integer | CONTROL_VIDEO_STABILIZATION_MODE | 视频稳定是否活跃。 |
| Creator CaptureRequest | CREATOR | |
| Key Integer | EDGE_MODE | 边缘增强的操作模式。 |
| Key Integer | FLASH_MODE | 闪存模式 |
| Key Integer | HOT_PIXEL_MODE | 热像素校正的操作模式。 |
| Key Location | JPEG_GPS_LOCATION | 在生成图像GPS元数据时使用的位置对象。 |
| Key Integer | JPEG_ORIENTATION | 一个JPEG图像的朝向。 |
| Key Byte | JPEG_QUALITY | 最终JPEG图像的压缩质量 |
| Key Size | JPEG_THUMBNAIL_SIZE | 嵌入的JPEG缩略图的解析。 |
| Key Float | LENS_APERTURE | 所需的镜头光圈大小，作为透镜焦距与有效孔径的比值。 |
| Key Float | LENS_FILTER_DENSITY | 镜头中性密度滤光片(s)所需的设置。 |
| Key Float | LENS_FOCAL_LENGTH | 想要的镜头焦距;用于光学变焦。 |
| Key Float | LENS_FOCUS_DISTANCE | 从镜头的最前表面测量到最尖锐焦点的距离。 |
| Key Integer | LENS_OPTICAL_STABILIZATION_MODE | 设置相机设备在拍摄图像时是否使用光学图像稳定(OIS)。 |
| Key Integer | NOISE_REDUCTION_MODE | 降噪算法的操作模式。 |
| Key Float | REPROCESS_EFFECTIVE_EXPOSURE_FACTOR | 在进行再加工前，应用处理的应用程序处理的暴露时间增加了。 |
| Key Rect | SCALER_CROP_REGION | 传感器所需要的区域来读取这个捕获(拍某个形状的设置) |
| Key Long | SENSOR_EXPOSURE_TIME | 持续每一个像素都暴露在光中。 |
| Key Long | SENSOR_FRAME_DURATION | 从帧曝光开始到下一个帧曝光的持续时间。 |
| Key Integer | SENSOR_SENSITIVITY | 处理前的传感器数据的增益。 |
| Key int[] | SENSOR_TEST_PATTERN_DATA | 当android.sensor.testPatternMode是 SOLID_COLOR，一个pixel[R, G_even, G_odd, B]提供测试模式的像素 |
| Key Integer | SENSOR_TEST_PATTERN_MODE | 当启用时，传感器会发送一个测试模式，而不是从摄像机中进行真实的曝光。 |
| Key Integer | SHADING_MODE | 镜头阴影校正的质量应用于图像数据。 |
| Key Integer | STATISTICS_FACE_DETECT_MODE | 人脸检测装置的工作模式。 |
| Key Boolean | STATISTICS_HOT_PIXEL_MAP_MODE | 热像素映射生成的操作模式。 |
| Key Integer | STATISTICS_LENS_SHADING_MAP_MODE | 摄像机设备是否会输出结果元数据中的镜头着色图。 |
| Key TonemapCurve | TONEMAP_CURVE | 当android.tonemap.mode 是CONTRAST_CURVE时，使用音调/对比度/伽玛曲线 |
| Key Float | ONEMAP_GAMMA | android.tonemap.mode 是GAMMA_VALUE时，使用Tonemapping曲线。tonemap曲线将定义如下公式:OUT=pow(在1.0/gamma中)输入的像素值被缩放到范围0.0，1.0，pow是能量函数，而伽玛是这个键所指定的伽马值。 |
| Key Integer | TONEMAP_MODE | 高级全球对比/γ/ tonemapping控制。 |
| Key Integer | TONEMAP_PRESET_CURVE | android.tonemap.mode 是 PRESET_CURVE时，使用Tonemapping曲线。tonemap曲线将由指定的标准定义。 |
<1-1>CaptureRequest.Builder
CaptureRequest内部类Builder，捕获请求的构建器。要获得构建器实例，可以使用CameraDeviced的createCaptureRequest(int)方法，该方法将请求字段初始化为在CameraDevice定义的一个模板。
| 返回值(public static final ) | 方法名 | 解释 |
|---|---|---|
| addTarget(Surface outputTarget) | 向该请求的目标列表添加一个表面。当请求被发送给摄像机设备时，添加的表面必须是最近调用createCaptureSession(List, CameraCaptureSession.StateCallback, Handler)方法的一个表面。 | |
| CaptureRequest | build() | 使用当前目标表面和设置构建一个请求。 |
| T | get(Key key) | 获取抓捕请求字段值 |
| removeTarget(Surface outputTarget) | 从这个请求的目标列表中删除一个表面。 | |
| set(Key key, T value) | 将捕获请求字段设置为一个值 | |
| setTag(Object tag) | 为这个请求设置一个标记。 |
常用的方法已加粗，通过CaptureRequest.Builder的set(Key key, T value)方法设置各种参数，比如自动对焦，设置flash，key值就是上面表中CaptureRequest的字段表，再通过build()方法生成CaptureRequest对象。注意，CaptureRequest继承于CameraMetadata类，CameraMetadata类的字段才是相机属性值的基类。
<2>CameraCharacteristics
| 返回值 | 方法 | 解释 |
|---|---|---|
| T | get(Key key) | 获取捕获请求字段值。 |
| List Key | getAvailableCaptureRequestKeys() | 获取CaptureRequest设置给CameraDevice的键值集合 |
| List Key | getAvailableCaptureResultKeys() | 获取CaptureResult设置给CameraDevice的键值集合 |
| List Key | getKeys() | 获取map中的键值集合 |
| 返回值(public static final ) | 字段名 | 解释 |
|---|---|---|
| Key int[] | COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES | 异常校正模式 |
| Key int[] | CONTROL_AE_AVAILABLE_ANTIBANDING_MODES | 自动曝光反带模式列表 |
| Key int[] | CONTROL_AE_AVAILABLE_MODES | 在自动曝光模式列表 |
| Key Range | CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES | 帧速率范围表 |
| Key Rational | CONTROL_AE_COMPENSATION_STEP | 最小的一步，可以改变曝光补偿。 |
| Key int[] | CONTROL_AF_AVAILABLE_MODES | 自动对焦(AF)列表 |
| Key int[] | CONTROL_AVAILABLE_EFFECTS | 色彩效果列表 |
| Key int[] | CONTROL_AVAILABLE_MODES | 控制模式列表 |
| Key int[] | CONTROL_AVAILABLE_SCENE_MODES | 场景列表模式 |
| Key int[] | CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES | 视频稳定模式列表 |
| Key int[] | CONTROL_AWB_AVAILABLE_MODES | 白平衡模式列表 |
| Key Boolean | CONTROL_AWB_LOCK_AVAILABLE | 相机设备支持MANUAL_POST_PROCESSING或BURST_CAPTURE则为true |
| Key Integer | CONTROL_MAX_REGIONS_AE | 自动曝光(AE)例程可使用的最大计量区域数。 |
| Key Integer | CONTROL_MAX_REGIONS_AF | 自动对焦(AF)例程可使用的最大计量区域数。 |
| Key Integer | CONTROL_MAX_REGIONS_AWB | 自动白平衡(AWB)例程可使用的最大计量区域数。 |
| Key Range | CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE | 范围的增加 |
| Key Boolean | DEPTH_DEPTH_IS_EXCLUSIVE | 表示捕获请求是否可以同时针对DEPTH16/depthpointcloud输出，以及正常的颜色输出(例如yuv420888、JPEG或RAW)。 |
| Key int[] | EDGE_AVAILABLE_EDGE_MODES | 边缘增强模式列表 |
| Key Boolean | FLASH_INFO_AVAILABLE | 相机是否有闪光灯单元 |
| Key int[] | HOT_PIXEL_AVAILABLE_HOT_PIXEL_MODES | 热像素校正模式列表 |
| Key Integer | INFO_SUPPORTED_HARDWARE_LEVEL | 通常将相机设备功能的整体分类。 |
| Key Size[] | JPEG_AVAILABLE_THUMBNAIL_SIZES | JPEG缩略图的列表 |
| Key Integer | LENS_FACING | 摄像机相对于设备屏幕的方向 |
| Key float[] | LENS_INFO_AVAILABLE_APERTURES | 孔径尺寸值表 |
| Key float[] | LENS_INFO_AVAILABLE_FILTER_DENSITIES | 中性密度滤波器值表 |
| Key float[] | LENS_INFO_AVAILABLE_FOCAL_LENGTHS | 焦距列表 |
| Key int[] | LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION | 光学图像稳定(OIS)模式列表 |
| Key Integer | LENS_INFO_FOCUS_DISTANCE_CALIBRATION | 镜头聚焦距离校准质量。 |
| Key Float | LENS_INFO_HYPERFOCAL_DISTANCE | 这个镜头的超焦距。 |
| Key Float | LENS_INFO_MINIMUM_FOCUS_DISTANCE | 在镜头前的最短距离，可以把焦点集中在镜头的最前面。 |
| Key float[] | LENS_INTRINSIC_CALIBRATION | 该相机设备的固有校正参数。 |
| Key float[] | LENS_POSE_ROTATION | 传感器坐标系统的方向。 |
| Key float[] | LENS_POSE_TRANSLATION | 照相机光学中心的位置。 |
| Key float[] | LENS_RADIAL_DISTORTION | 修正了该相机装置的径向和切向透镜畸变的校正系数。 |
| Key int[] | NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES | 噪声抑制方式表 |
| Key Integer | REPROCESS_MAX_CAPTURE_STALL | 通过重新处理捕获请求引入的最大摄相机捕获管道(在帧数单元中)。 |
| Key int[] | REQUEST_AVAILABLE_CAPABILITIES | 这个相机设备所宣传的功能是完全支持的。 |
| Key Integer | REQUEST_MAX_NUM_INPUT_STREAMS | 任何类型的输入流的最大数量，可以同时被摄像机设备配置和使用。 |
| Key Integer | REQUEST_MAX_NUM_OUTPUT_PROC | 不同类型的输出流的最大数量，可以同时配置和使用一个摄像机设备来处理任何处理的(但不是停滞的)格式。 |
| Key Integer | REQUEST_MAX_NUM_OUTPUT_PROC_STALLING | 可以对任意处理(和停止)格式的摄像机设备同时配置和使用的不同类型的输出流的最大数量。 |
| Key Integer | REQUEST_MAX_NUM_OUTPUT_RAW | 不同类型的输出流的最大数量，可以同时配置和使用任何原始格式的摄像机设备。 |
| Key Integer | REQUEST_PARTIAL_RESULT_COUNT | 定义一个结果将由多少子组件组成。 |
| Key Byte | REQUEST_PIPELINE_MAX_DEPTH | 指定一个框架必须经历的最大管道阶段的数量，当它暴露在框架下的时候。 |
| Key Float | SCALER_AVAILABLE_MAX_DIGITAL_ZOOM | 活动区域宽度和作物区域宽度、活动区高度和作物区高度之间的最大比率， |
| Key Integer | SCALER_CROPPING_TYPE | 这个相机设备所支持的裁剪类型。 |
| Key StreamConfigurationMap | SCALER_STREAM_CONFIGURATION_MAP | 这个相机设备支持的可用的流配置;还包括最小帧持续时间和每个格式/大小组合的停顿时间。 |
| Key int[] | SENSOR_AVAILABLE_TEST_PATTERN_MODES | 传感器测试模式模式列表 |
| Key BlackLevelPattern | SENSOR_BLACK_LEVEL_PATTERN | 每一种颜色过滤装置(CFA)马赛克通道都有固定的黑色电平。 |
| Key ColorSpaceTransform | SENSOR_CALIBRATION_TRANSFORM1 | 每个设备的校准转换矩阵，从参考传感器的色彩空间映射到实际的设备传感器的色彩空间。 |
| Key ColorSpaceTransform | SENSOR_CALIBRATION_TRANSFORM2 | 每个设备的校准转换矩阵，从参考传感器的色彩空间映射到实际的设备传感器的色彩空间(这是原始缓冲区数据的色彩空间)。 |
| Key ColorSpaceTransform | SENSOR_COLOR_TRANSFORM1 | 一个矩阵，它将颜色值从CIE XYZ颜色空间转换为参考传感器颜色空间。 |
| Key ColorSpaceTransform | SENSOR_COLOR_TRANSFORM2 | 一个矩阵，它将颜色值从CIE XYZ颜色空间转换为参考传感器颜色空间。 |
| Key ColorSpaceTransform | SENSOR_FORWARD_MATRIX1 | 一个矩阵，它将白色平衡摄像机的颜色从参考传感器的色彩空间转换为带有D50白色点的CIE XYZ颜色空间。 |
| Key ColorSpaceTransform | SENSOR_FORWARD_MATRIX2 | 一个矩阵，它将白色平衡摄像机的颜色从参考传感器的色彩空间转换为带有D50白色点的CIE XYZ颜色空间。 |
| Key Size | SENSOR_INFO_PIXEL_ARRAY_SIZE | 全像素数组的尺寸，可能包括黑色校准像素 |
| Key Rect | SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE | 在应用任何几何畸变校正之前，图像传感器的区域与活动的像素相对应。 |
| Key Range | SENSOR_INFO_SENSITIVITY_RANGE | 敏感的范围 |
| Key Integer | SENSOR_INFO_TIMESTAMP_SOURCE | 传感器捕获的时间基准源开始时间戳。 |
| Key Integer | SENSOR_INFO_WHITE_LEVEL | 传感器的最大原始值输出。 |
| Key Integer | SENSOR_MAX_ANALOG_SENSITIVITY | 最大灵敏度是通过模拟增益实现的。 |
| Key Integer | SENSOR_OPTICAL_BLACK_REGIONS | 显示传感器光学屏蔽黑色像素区域的分离矩形的列表。 |
| Key Rect[] | SENSOR_OPTICAL_BLACK_REGIONS | 显示传感器光学屏蔽黑色像素区域的分离矩形的列表。 |
| Key Integer | SENSOR_ORIENTATION | 顺时针方向的角度，在设备屏幕上，输出图像需要旋转以保持在本机定位上。 |
| Key Integer | SENSOR_REFERENCE_ILLUMINANT1 | 标准参考光源用作场景光源 |
| Key Byte | SENSOR_REFERENCE_ILLUMINANT2 | |
| Key int[] | SHADING_AVAILABLE_MODES | 透镜阴影模式列表 |
| Key int[] | STATISTICS_INFO_AVAILABLE_FACE_DETECT_MODES | 人脸检测方式 |
| Key boolean[] | STATISTICS_INFO_AVAILABLE_HOT_PIXEL_MAP_MODES | 热像素映射输出模式列表 |
| Key int[] | STATISTICS_INFO_AVAILABLE_LENS_SHADING_MAP_MODES | 镜头阴影贴图输出模式列表 |
| Key Integer | STATISTICS_INFO_MAX_FACE_COUNT | 同时可检测到的人脸的最大数量。 |
| Key Integer | SYNC_MAX_LATENCY | 提交请求后(不同于之前的)的最大帧数被提交，并且在结果的状态变为同步之前。 |
| Key int[] | TONEMAP_AVAILABLE_TONE_MAP_MODES | tonemapping列表模式 |
| Key Integer | TONEMAP_MAX_CURVE_POINTS |
<3>TotalCaptureResult
| 返回值 | 方法 | 解释 |
|---|---|---|
| List CaptureResult | getPartialResults() | 获得组成这个总结果的部分结果的只读列表。 |
<4>CaptureResult
CaptureResult的所有字段和CaptureRequest相同，请参考上边列表即可，下表是暴露的方法：
| 返回值 | 方法 | 解释 |
|---|---|---|
| T | get(Key key) | 获取捕获请求字段值。 |
| long | getFrameNumber() | 得到与这个结果相关联的帧数。 |
| List Key | getKeys() | 返回该map中包含的键列表。 |
| CaptureRequest | getRequest() | 获取与此结果相关联的请求。 |
| int | getSequenceId() | CameraCaptureSession的capture(CaptureRequest,CameraCaptureSession.CaptureCallback, Handler)家庭的功能返回失败的序列ID |
<5>基类CameraMetadata
摄像机控制和信息的基类。
这个类定义了用于查询相机特性或捕获结果的基本键/值映射，以及设置相机请求参数。
照相机的所有实例都是不可变的。getKeys()的键列表永远不会改变，也不会在对象的生命周期中返回任何键返回的值。
如下字段当做手册查询即可:
| 字段名(int ) | 解释 |
|---|---|
| COLOR_CORRECTION_ABERRATION_MODE_FAST | 异常校正不会降低相对于传感器原始输出的捕获率。 |
| COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY | 异常校正在提高质量上运行，但捕获率可能降低(相对于传感器的原始输出率)。 |
| COLOR_CORRECTION_ABERRATION_MODE_OFF | 不进行异常校正。 |
| COLOR_CORRECTION_MODE_FAST | 颜色校正处理不能降低相对于传感器原始输出的捕获率。 |
| COLOR_CORRECTION_MODE_HIGH_QUALITY | 在指定的白色平衡管道上方或以上的高级白色平衡调整可能被应用。 |
| COLOR_CORRECTION_MODE_TRANSFORM_MATRIX | 使用android.colorCorrection.transform 矩阵 和android.colorCorrection.gains来做颜色转换 |
| CONTROL_AE_ANTIBANDING_MODE_50HZ | 这款相机将调整曝光时间，以避免使用50Hz的照明电源。 |
| CONTROL_AE_ANTIBANDING_MODE_60HZ | 这款相机将调整曝光时间，以避免使用60Hz的照明电源。 |
| CONTROL_AE_ANTIBANDING_MODE_AUTO | 自适应照明条件 |
| CONTROL_AE_ANTIBANDING_MODE_OFF | 相机设备不会调整曝光时间以避免出现问题。 |
| CONTROL_AE_MODE_OFF | 相机设备的自动曝光程序被禁用。 |
| CONTROL_AE_MODE_ON | 相机设备的自动曝光程序是主动的，没有闪光控制。 |
| CONTROL_AE_MODE_ON_ALWAYS_FLASH | 闪光灯一直打开 |
| CONTROL_AE_MODE_ON_AUTO_FLASH | 自适应，在光线较弱的情况下发射 |
| CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE | 自适应，但自动红眼减少 |
| CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL | 相机设备将取消当前的任何活动或已完成的预捕捉测量序列，自动曝光程序将返回其初始状态 |
| CONTROL_AE_PRECAPTURE_TRIGGER_IDLE | 触发器是空闲的。 |
| CONTROL_AE_PRECAPTURE_TRIGGER_START | 预捕获的测量序列将由摄像机设备启动。 |
| CONTROL_AE_STATE_CONVERGED | AE对当前场景有很好的控制值。 |
| CONTROL_AE_STATE_FLASH_REQUIRED | AE有一组很好的控制值，但是flash需要被触发，因为它的质量仍然很好。 |
| CONTROL_AE_STATE_INACTIVE | AE关闭或最近重置。 |
| CONTROL_AE_STATE_LOCKED | AE被锁定 |
| CONTROL_AE_STATE_PRECAPTURE | AE被要求做一个预捕获序列，目前正在执行它。 |
| CONTROL_AE_STATE_SEARCHING | AE在当前场景中还没有一组良好的控制值。 |
| CONTROL_AF_MODE_AUTO | 基本的自动对焦模式。 |
| CONTROL_AF_MODE_CONTINUOUS_PICTURE | 在这种模式下，AF算法不断地修改镜头位置，试图提供一个恒定不变的图像流。 |
| CONTROL_AF_MODE_CONTINUOUS_VIDEO | 在这种模式下，AF算法不断地修改镜头位置，试图提供一个恒定不变的视频流。 |
| CONTROL_AF_MODE_EDOF | 扩展的景深(数字焦点)模式。 |
| CONTROL_AF_MODE_MACRO | 特写镜头聚焦模式。 |
| CONTROL_AF_MODE_OFF | 自动对焦程序无法控制镜头，android.lens.focusDistance 由应用程序控制 |
| CONTROL_AF_STATE_ACTIVE_SCAN | AF正在执行一个AF扫描，因为它是由AF触发器触发的。 |
| CONTROL_AF_STATE_FOCUSED_LOCKED | AF相信它是正确的并且锁定了焦点。 |
| CONTROL_AF_STATE_INACTIVE | AF已经关闭，或者还没有被要求扫描。 |
| CONTROL_AF_STATE_NOT_FOCUSED_LOCKED | AF未能成功地集中注意力，并且锁定了焦点。 |
| CONTROL_AF_STATE_PASSIVE_FOCUSED | AF目前认为它是焦点，但可能在任何时候重新启动扫描。 |
| CONTROL_AF_STATE_PASSIVE_SCAN | AF目前正在进行一种自动对焦模式的自动对焦，这是一种持续的自动对焦模式。 |
| CONTROL_AF_STATE_PASSIVE_UNFOCUSED | AF在没有找到焦点的情况下完成了被动扫描，并且可以在任何时候重新启动扫描。 |
| CONTROL_AF_TRIGGER_CANCEL | 自动对焦将返回到初始状态，并取消任何当前的活动触发器。 |
| CONTROL_AF_TRIGGER_IDLE | 触发器是空闲的。 |
| CONTROL_AF_TRIGGER_START | 自动对焦现在将触发。 |
| CONTROL_AWB_MODE_AUTO | 自动白平衡程序是主动的 |
| CONTROL_AWB_MODE_CLOUDY_DAYLIGHT | 相机装置使用浑浊的日光作为白色平衡的假设场景照明 |
| CONTROL_AWB_MODE_DAYLIGHT | 相机装置使用日光照明作为白色平衡的假设场景照明。 |
| CONTROL_AWB_MODE_FLUORESCENT | 相机装置使用荧光灯作为白色平衡的假设场景照明。 |
| CONTROL_AWB_MODE_INCANDESCENT | 相机装置使用白炽灯作为白色平衡的假设场景照明。 |
| CONTROL_AWB_MODE_OFF | 相机装置的自动白平衡程序被禁用。 |
| CONTROL_AWB_MODE_SHADE | 相机装置使用遮光灯作为白色平衡的假设场景照明。 |
| CONTROL_AWB_MODE_TWILIGHT | 相机装置使用微光作为白色平衡的假设场景照明。 |
| CONTROL_AWB_MODE_WARM_FLUORESCENT | 相机装置使用温暖的荧光灯作为白色平衡的假设场景照明。 |
| CONTROL_AWB_STATE_CONVERGED | AWB(自动白平衡)对当前场景有一组很好的控制值。 |
| CONTROL_AWB_STATE_INACTIVE | AWB不是自动模式，或者还没有开始测量。 |
| CONTROL_AWB_STATE_LOCKED | AWB被锁定 |
| CONTROL_AWB_STATE_SEARCHING | AWB在当前场景中还没有很好的控制值。 |
| CONTROL_CAPTURE_INTENT_CUSTOM | 这个请求的目标不属于其他类别。 |
| CONTROL_CAPTURE_INTENT_MANUAL | 此请求用于手动捕获用例，其中应用程序希望直接控制捕获参数。 |
| CONTROL_CAPTURE_INTENT_PREVIEW | 这个请求是一个类似于预览的用例。 |
| CONTROL_CAPTURE_INTENT_STILL_CAPTURE | 这个请求是针对一个静态捕获类型的用例。 |
| CONTROL_CAPTURE_INTENT_VIDEO_RECORD | 这个请求是一个视频记录用例。 |
| CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT | 这个请求是用于一个视频快照(在录制视频时仍然是图像)用例。 |
| CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG | 此请求适用于ZSL usecase;该应用程序将会流全解析度的图像，然后再处理一个或几个，最后捕获。 |
| CONTROL_EFFECT_MODE_AQUA | 一种“aqua”效应，将蓝色的色调添加到图像中。 |
| CONTROL_EFFECT_MODE_BLACKBOARD | 一种“黑板”效应，图像通常显示为黑色区域，有白色或灰色的细节。 |
| CONTROL_EFFECT_MODE_MONO | 一种“单色”效果，将图像映射成单一颜色。 |
| CONTROL_EFFECT_MODE_NEGATIVE | 图像的颜色颠倒的“光负”效应。 |
| CONTROL_EFFECT_MODE_OFF | 不会使用彩色效果。 |
| CONTROL_EFFECT_MODE_POSTERIZE | 一种“色调分离”的效果，即图像使用音调的离散区域而不是连续的音调梯度。 |
| CONTROL_EFFECT_MODE_SEPIA | 一种“深褐色”效应，图像被映射成温暖的灰色、红色和棕色的色调。 |
| CONTROL_EFFECT_MODE_SOLARIZE | 一种“太阳化”效果(Sabattier effect)，在这里，图像完全或部分地颠倒了。 |
| CONTROL_EFFECT_MODE_WHITEBOARD | 一个“白板”效果，图像通常显示为白色区域，有黑色或灰色的细节。 |
| CONTROL_MODE_AUTO | 每个3A例程使用设置。 |
| CONTROL_MODE_OFF | 管道的完全应用控制。 |
| CONTROL_MODE_OFF_KEEP_STATE | 与OFF模式相同，除了这个捕捉不会被摄像机设备背景自动曝光，自动白平衡和自动对焦算法(3A)更新他们的统计数据。 |
| CONTROL_MODE_USE_SCENE_MODE | 使用特定的场景模式。 |
| CONTROL_SCENE_MODE_ACTION | 对快速移动对象的照片进行优化。 |
| CONTROL_SCENE_MODE_BARCODE | 为精确捕捉条形码的照片而进行优化，以供希望读取条形码值的相机应用程序使用。 |
| CONTROL_SCENE_MODE_BEACH | 为明亮的户外海滩设置优化。 |
| CONTROL_SCENE_MODE_CANDLELIGHT | 在主要光源为火焰的昏暗环境中进行优化。 |
| CONTROL_SCENE_MODE_DISABLED | 指示没有为给定的捕获请求设置场景模式。 |
| CONTROL_SCENE_MODE_FACE_PRIORITY | 如果存在面部检测支持，使用面部检测数据自动对焦、自动白平衡和自动曝光程序。 |
| CONTROL_SCENE_MODE_FIREWORKS | 优化了晚上的焰火照片。 |
| CONTROL_SCENE_MODE_HDR | 打开设备特定的高动态范围(HDR)模式。 |
| CONTROL_SCENE_MODE_LANDSCAPE | 对远处宏观物体的照片进行优化。 |
| CONTROL_SCENE_MODE_NIGHT | 优化低光线设置。 |
| CONTROL_SCENE_MODE_NIGHT_PORTRAIT | 对低光环境下的人的静态照片进行优化。 |
| CONTROL_SCENE_MODE_PARTY | 为昏暗，室内设置和多个移动的人优化。 |
| CONTROL_SCENE_MODE_PORTRAIT | 优化了人们的静态照片。 |
| CONTROL_SCENE_MODE_SNOW | 为明亮的，室外设置的雪优化 |
| CONTROL_SCENE_MODE_SPORTS | 对快速移动的人的照片进行优化。 |
| CONTROL_SCENE_MODE_STEADYPHOTO | 由于设备运动的量小而优化避免了模糊的照片(例如:由于握手)。 |
| CONTROL_SCENE_MODE_SUNSET | 对落日场景进行了优化。 |
| CONTROL_SCENE_MODE_THEATRE | 对昏暗的室内设置进行优化，闪光灯必须保持关闭状态。 |
| CONTROL_VIDEO_STABILIZATION_MODE_OFF | 视频稳定是禁用的。 |
| CONTROL_VIDEO_STABILIZATION_MODE_ON | 启用视频稳定。 |
| EDGE_MODE_FAST | 在质量水平上应用边缘增强，它不会减慢帧率相对于传感器输出。 |
| EDGE_MODE_HIGH_QUALITY | 应用高质量的边缘增强，以降低输出帧率的代价。 |
| EDGE_MODE_OFF | 没有使用边缘增强。 |
| EDGE_MODE_ZERO_SHUTTER_LAG | 基于分辨率的不同输出流，边缘增强应用于不同的层次。 |
| FLASH_MODE_OFF | 不适用闪光灯 |
| FLASH_MODE_SINGLE | 如果闪光灯是可用的，并且被充电，那就用闪光灯来捕捉。 |
| FLASH_MODE_TORCH | 闪光持续不断。 |
| FLASH_STATE_CHARGING | 闪光灯在充电，不能使用 |
| FLASH_STATE_FIRED | 这次抓拍使用闪光 |
| FLASH_STATE_PARTIAL | 闪光部分照亮了这帧。 |
| FLASH_STATE_READY | Flash已经准备好使用了。 |
| FLASH_STATE_UNAVAILABLE | 相机不支持闪光灯 |
| HOT_PIXEL_MODE_FAST | 采用热像素校正，不降低帧率，相对于传感器的原始输出。 |
| HOT_PIXEL_MODE_HIGH_QUALITY | 采用高质量的热像素校正，相对于传感器的原始输出，其帧速率可能会降低。 |
| HOT_PIXEL_MODE_OFF | 没有使用热像素校正。 |
| INFO_SUPPORTED_HARDWARE_LEVEL_3 | 这款相机的设备可以进行YUV的再处理和原始数据采集，同时具备全层功能。 |
| INFO_SUPPORTED_HARDWARE_LEVEL_FULL | 该相机装置能够支持先进的成像应用。 |
| INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY | 这个相机设备运行在向后兼容模式。 |
| INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED | 这个相机设备没有足够的能力来满足成为一个完整的设备或更好。 |
| LENS_FACING_BACK | 后置摄像头。 |
| LENS_FACING_EXTERNAL | 外部摄像头，没有固定的相对于设备的屏幕 |
| LENS_FACING_FRONT | **前置摄像头 |
| LENS_INFO_FOCUS_DISTANCE_CALIBRATION_APPROXIMATE | 镜头焦距以屈光度测量。 |
| LENS_INFO_FOCUS_DISTANCE_CALIBRATION_CALIBRATED | 用屈光度测量了透镜的焦距，并进行了校正。 |
| LENS_INFO_FOCUS_DISTANCE_CALIBRATION_UNCALIBRATED | 镜头焦距不准确,用于android.lens.focusDistance的单元不对应于任何物理单元 |
| LENS_OPTICAL_STABILIZATION_MODE_OFF | 光学稳定不可用。 |
| LENS_OPTICAL_STABILIZATION_MODE_ON | 光学稳定可用。 |
| LENS_STATE_MOVING | 一个或几个镜头参数(android.lens.focalLength, android.lens.focusDistance, android.lens.filterDensity or android.lens.aperture)正在改变 |
| LENS_STATE_STATIONARY | 一个或几个镜头参数(android.lens.focalLength, android.lens.focusDistance, android.lens.filterDensity and android.lens.aperture) 没有改变 |
| NOISE_REDUCTION_MODE_FAST | 在不降低相对于传感器输出的帧率的情况下应用降噪。 |
| NOISE_REDUCTION_MODE_HIGH_QUALITY | 采用高质量的降噪方法，降低了相对于传感器输出的帧率。 |
| NOISE_REDUCTION_MODE_MINIMAL | 在不降低传感器输出的帧率的情况下，应用最小的降噪方法。 |
| NOISE_REDUCTION_MODE_OFF | 不应用降噪。 |
| NOISE_REDUCTION_MODE_ZERO_SHUTTER_LAG | 根据分辨率，不同的输出流采用不同的降噪方法。 |
| REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE | 最小功能集,每个相机设备(无论android.info.supportedHardwareLevel)支持。 |
| REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE | 相机设备支持在> = 20帧每秒捕获高分辨率图像，至少在未压缩的YUV格式下，当处理后设置快速设置时。 |
| REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO | 该设备支持受约束的高速视频记录(帧速率> = 120fps)用例。 |
| REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT | 摄像机装置可以从它的视野中产生深度测量。 |
| REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING | 后处理阶段的摄像装置可以手动控制。 |
| REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR | 相机设备可以手动控制(比如自动曝光，自动对焦等3A算法)。 |
| REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING | 相机设备支持零快门延迟后处理用例。 |
| REQUEST_AVAILABLE_CAPABILITIES_RAW | 摄像机设备支持输出原始缓冲区和元数据来解释它们。 |
| REQUEST_AVAILABLE_CAPABILITIES_READ_SENSOR_SETTINGS | 当内置的3A算法在运行时，相机设备支持精确地报告传感器的设置。 |
| REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING | ，即摄像头设备支持YUV_420_888后处理用例，类似于PRIVATE_REPROCESSING，该功能要求摄像头设备支持以下内容:支持一个输入流，即android.request。maxNumInputStreams = = 1 |
| SCALER_CROPPING_TYPE_CENTER_ONLY | 相机装置只支持中心的作物区域。 |
| SCALER_CROPPING_TYPE_FREEFORM | 相机装置支持任意选择的作物区域。 |
| SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_BGGR | |
| SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG | |
| SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG | |
| SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG | 传感器不是拜耳;输出的每个像素值为3个16位值，而不是每个像素只有1个16位的值。 |
| SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGGB | |
| SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME | android.sensor.timestamp和elapsedRealtimeNanos()时间戳相同,它们可以与使用该基础的其他时间戳进行比较。 |
| SENSOR_INFO_TIMESTAMP_SOURCE_UNKNOWN | android.sensor.timestamp的时间戳以纳秒和单调为单位，但不能与其他子系统的时间戳进行比较 |
| SENSOR_REFERENCE_ILLUMINANT1_CLOUDY_WEATHER | |
| SENSOR_REFERENCE_ILLUMINANT1_COOL_WHITE_FLUORESCENT | W 3900 - 4500K |
| SENSOR_REFERENCE_ILLUMINANT1_D50 | |
| SENSOR_REFERENCE_ILLUMINANT1_D55 | |
| SENSOR_REFERENCE_ILLUMINANT1_D65 | |
| SENSOR_REFERENCE_ILLUMINANT1_D75 | |
| SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT | |
| SENSOR_REFERENCE_ILLUMINANT1_FINE_WEATHER | |
| SENSOR_REFERENCE_ILLUMINANT1_FLASH | |
| SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT | |
| SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN | |
| SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN | |
| SENSOR_REFERENCE_ILLUMINANT1_STANDARD_A | |
| SENSOR_REFERENCE_ILLUMINANT1_STANDARD_B | |
| SENSOR_REFERENCE_ILLUMINANT1_STANDARD_C | |
| SENSOR_REFERENCE_ILLUMINANT1_TUNGSTEN | 白炽灯 |
| SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT | D 5700 - 7100K |
| SENSOR_REFERENCE_ILLUMINANT1_DAY_WHITE_FLUORESCENT | N 4600 - 5400K |
| SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT | WW 3200 - 3700K |
| ENSOR_TEST_PATTERN_MODE_COLOR_BARS | 所有的像素数据被一个8小节的颜色模式取代。 |
| SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY | 测试模式与COLOR_BARS类似，只是每个条都应该从顶部的指定颜色开始，并在底部渐变为灰色。 |
| SENSOR_TEST_PATTERN_MODE_CUSTOM1 | 第一个自定义测试模式。 |
| SENSOR_TEST_PATTERN_MODE_OFF | 没有使用测试模式模式，相机设备返回从图像传感器捕获。 |
| SENSOR_TEST_PATTERN_MODE_PN9 | 所有像素数据都由pn9512位序列生成的伪随机序列(通常在带有线性反馈移位寄存器的硬件中实现)所替代。 |
| SENSOR_TEST_PATTERN_MODE_SOLID_COLOR | SENSOR_TEST_PATTERN_MODE_SOLID_COLOR提供的每个像素的[R, G_even, G_odd, B]被其各自的颜色通道所取代 |
| SHADING_MODE_FAST | 应用镜头遮阳校正，不减慢帧率相对于传感器的原始输出 |
| SHADING_MODE_HIGH_QUALITY | 采用高质量的镜片阴影校正，以降低帧率为代价。 |
| SHADING_MODE_OFF | 不使用镜片阴影校正。 |
| STATISTICS_FACE_DETECT_MODE_FULL | 返回所有元数据。 |
| STATISTICS_FACE_DETECT_MODE_OFF | 在捕获结果中不包括人脸检测统计。 |
| STATISTICS_FACE_DETECT_MODE_SIMPLE | 只返回矩形和置信值。 |
| STATISTICS_LENS_SHADING_MAP_MODE_OFF | 在捕获结果中不包括镜头阴影图。 |
| STATISTICS_LENS_SHADING_MAP_MODE_ON | 在捕获结果中包括一个镜头阴影图 |
| STATISTICS_SCENE_FLICKER_50HZ | 相机设备在当前场景中检测到50Hz的照明。 |
| STATISTICS_SCENE_FLICKER_60HZ | |
| STATISTICS_SCENE_FLICKER_NONE | 摄像机设备没有检测到当前场景中任何闪烁的照明 |
| SYNC_MAX_LATENCY_PER_FRAME_CONTROL | 每一帧都有立即应用的请求。 |
| SYNC_MAX_LATENCY_UNKNOWN | 每一新帧都有一些过去请求应用到相机设置的子集(可能是整个集合)。 |
| TONEMAP_MODE_CONTRAST_CURVE | |
| TONEMAP_MODE_FAST | 在不降低帧速率的情况下，可以应用高级的伽马映射和颜色增强。 |
| TONEMAP_MODE_GAMMA_VALUE | 使用android.tonemap中指定的伽玛值 |
| 使用android.tonemap中指定的伽玛值 | 高质量的伽马映射和彩色增强将会被应用，与原始传感器输出相比，可能会降低帧速率。 |
| TONEMAP_MODE_PRESET_CURVE | 使用android.tonemap中指定的预设置的tonemapping曲线 |
| TONEMAP_PRESET_CURVE_REC709 | onemapping曲线由itu - r bt709定义 |
| TONEMAP_PRESET_CURVE_SRGB | 调色曲线是由sRGB定义的 |
<6>照片数据处理类ImageReader
ImageReader extends Object
官方文档解释：
ImageReader类允许应用程序直接将图片数据渲染到Surface上
一些Android media API类允许将Surface类当做渲染目标，包括 MediaPlayer, MediaCodec, CameraDevice, ImageWriter 和Allocations. 每个源可以使用的图像大小和格式各不相同，并且应该在特定API的文档中进行检查。
图像数据被封装到Image对象中，同时也可以被多个这种对象访问。通过它的Surface类，新的Image数据将ImageReader类发送到队列，调用 ImageReader的acquireLatestImage() 或者oacquireNextImage() 方法接收Image数据。由于内存限制，如果ImageReader不能以与生产速率相同的速率获取和释放图像，那么图像源将最终停止或删除图像。
暴露的方法见下表：
| 返回值 | 方法 | 解释 |
|---|---|---|
| Image | acquireLatestImage() | 从ImageReader的队列中获取最新的图像，删除较旧的Image |
| Image | acquireNextImage() | 从ImageReader队列获取下一个图像 |
| close() | 释放与此ImageReader相关的所有资源。 | |
| int | getHeight() | 图像的默认高度，以像素为单位 |
| int | getImageFormat() | 图像的默认图像格式。 |
| int | getMaxImages() | 从ImageReader获得的最大数量的图像 |
| Surface | getSurface() | 获得一个可以用来为这个ImageReader生成图像的Surface |
| int | getWidth() | 图像的默认宽度，以像素为单位 |
| ImageReader | newInstance(int width, int height, int format, int maxImages) | 为想要的大小和格式创建一个新的对象 |
| setOnImageAvailableListener(ImageReader.OnImageAvailableListener listener, Handler handler) | 当一个新映像从ImageReader可用时，注册一个侦听器将被调用。 |
该表的setOnImageAvailableListener的第一个参数，就可以将获取的数据在任意地方实现，以便保存拍照的数据
<6>xml布局类TextureView
官方文档解释：
TextureView类可以展示内容流，这样的内容流可以是一个video或者一个OpenGL场景，内容流可以来自应用程序的流程和远程流程。
TextureView 只可以用于硬件加速窗口，当它在软件中渲染时，TextureView不画任何内容。
和SurfaceView不同，TextureView没有创建一个分离的窗口，它的行为是一个正常的视图。关键的区别是TextureView可以移动，转换，动画等。例如，你可以调用mView.setAlpha(0.5)方法让TextureView变成半透明。
使用 TextureView很简单，你只需要获取它的SurfaceTextrue，这个SurfaceTexture可用来渲染内容，SurfaceTexture对象可以通过getSurfaceTexture()方法或者TextureView.SurfaceTextureListener监听获得。重要的是要知道，只有TextureView在连接到窗口后，才可以使用SurfaceView(并且已经调用了TextureView的onAttachedToWindow()方法)。强烈建议使用监听器方式，以便在SurfaceTexture变成可用时，通知到监听中做处理。
需要注意的是，只有一个生产者可以使用TextureView，例如，如果你用TextureView展示相机预览，你就不能同时使用 lockCanvas()在TextureView上绘制。
| 返回值 | 方法 | 解释 |
|---|---|---|
| void | buildLayer() | 调用这种方法没有效果。 |
| final void | draw(Canvas canvas) | textureView的子类不能使用Canvas对象进行自己的渲染。 |
| Bitmap | getBitmap(int width, int height) | 返回SurfaceTexture相关内容的Bitmap对象 |
| Bitmap | getBitmap() | |
| Bitmap | getBitmap(Bitmap bitmap) | 将该视图的SurfaceTexture的内容复制到指定的bitmap中。 |
| int | getLayerType() | 返回LAYER_TYPE_HARDWARE. |
| SurfaceTexture | getSurfaceTexture() | 获取视图的SurfaceTexture 对象 |
| SurfaceTextureListener | getSurfaceTextureListener() | |
| Matrix | getTransform(Matrix transform) | 返回与此纹理视图关联的转换。 |
| boolean | isAvailable() | 如果与TextureView相关的 SurfaceTexture 可以用于呈现，则返回true |
| boolean | isOpaque() | 表示此视图是否不透明 |
| Canvas | lockCanvas() | 开始编辑表面的像素。 |
| Canvas | lockCanvas(Rect dirty) | 就像lockCanvas()，但是允许指定一个脏的矩形。 |
| void | setForeground(Drawable foreground) | 提供一个可以在视图中所有内容之上呈现的可绘制的图。 |
| void | setLayerPaint(Paint paint) | 更新当前layout中使用的paint对象(仅在当前层类型没有设置为LAYER_TYPE_NONE才可以使用) |
| void | setOpaque(boolean opaque) | 表示此文本检查的内容是否不透明。 |
| void | setLayerType(int layerType, Paint paint) | 当TextureView总被当做硬件层，这个层类型就会被忽略 |
| setSurfaceTexture(SurfaceTexture surfaceTexture) | 为视图添加SurfaceTexture使用（自定义使用） | |
| setSurfaceTextureListener(SurfaceTextureListener listener) | 监听TextureView事件 | |
| setTransform(Matrix transform) | 设置和TextureView相关的转换 | |
| unlockCanvasAndPost(Canvas canvas) | 结束像素编辑 |
Camera2的使用简单说就是，xml布局使用TextureView，操作流程都在android.hardware.camera2中，拍照结果用ImageReader处理。而具体的android.hardware.camera2中的操作，见下一篇文章介绍：
android基础总结：Camera2详解之二 官方demo解读及深入实现
https://blog.csdn.net/sjy0118/article/details/78748941