Android CameraX 自学之路

Android 开发自学之路（1）–CameraControl

作为一个之前没有接触过Android和Kotlin开发的小白，最近在自学Android开发。我将把自己学习的过程以笔记的形式分享在这里，如果有不正确的理解，希望大家能慷慨相告！

由于最近接触的项目与相机紧密相关，所以我的介绍从新发布的CameraX开始。

CameraX 概览

CameraX 是一个Jetpack的支持库，旨在帮助您简化相机应用的开发工作。它提供一致且易于使用的 api 界面，适用于大多数 Android 设备，并可向后兼容至 Android 5.0（API 级别 21）。

虽然它利用的是 camera2 的功能，但使用的是更为简单且基于用例的方法，该方法具有生命周期感知能力。它还解决了设备兼容性问题，因此您无需在代码库中包含设备专属代码。这些功能减少了将相机功能添加到应用时需要编写的代码量。

最后，借助 CameraX，开发者只需两行代码就能利用与预安装的相机应用相同的相机体验和功能。 CameraX Extensions 是可选插件，通过该插件，您可以在支持的设备上向自己的应用中添加人像、HDR、夜间模式和美颜等效果。（以上引用于 Android develpoer 的官方文档）。

在简单了解CameraX的功能之后，我们从官方提供的文档中，逐个类的进行记录他们的功能以及用法。(Kotlin Based)

android.camera.core 接口 Interfaces Camera

Camera 接口用来控制数据流通过CameraControl来控制相机，通过Camerainfo来发布相机的状态

Public methods:

getCameraControl():返回Camera的CameraControl。其中CameraControl提供给我们Zoom，focus，metering等操作，在这些使用案例bound到Camera之后，CameraControl就可以立即执行这些操作。当所有的使用案例都unbound，或者相机关闭亦或是生命周期中的onStop发生，CameraControl会拒绝所有操作。

每个CameraControl的方法都会返回一个ListenableFuture，可以放app检查这些操作的结果。如果操作在当前状态下不被允许，返回的ListenableFuture会报CameraControl.OperationCanceledException异常。

getCameraInfo:返回相机的信息

返回信息可以用于查询相机静态参数或观测相机的运行时间状态。

CameraControl

CameraControl在刚刚的Camera的getCameraControl()方法中已经介绍过。

Public methods:

cancelFocusAndMetering: 取消当前的FocusMeteringAction并清除AF/AE/AWB区域并更新当前的AF模式为continuous AF（如果支持的话）。如果当前FocusMeteringAction没有完成，则由startFocusAndMetering返回的ListenableFuture会报CameraControl.OperationCanceledException异常。

enableTorch:激活或关闭补光灯。CameraInfo.getTorchState()可以查询补光灯状态，如果相机没有补光灯（参考CameraInfo.hasFlashUnit()），请求将什么都不执行，返回的ListenableFuture为TorchState.OFF。当补光灯被使用（enabled）的时候，补光灯会持续工作无视falshmode的设置。当补光灯被禁用（disabled），补光灯将按照ImageCapture.setFlashMode(int)或者ImageCapture.Builder.setFlashMode(int)设置的方式使用。

setLineraZoom:通过范围从0f到1.0f的线性缩放值设置当前缩放。LinearZoom 0f表示最小缩放，而linearZoom 1.0f表示最大缩放。linearZoom的优点在于，它可以确保视场（FOV）随linearZoom值线性变化，以与滑块UI元素一起使用（同时setZoomRatio(float)适用于捏合缩放手势）。

它同时修改了当前的zoomRatio和linearZoom，因此，如果应用程序正在观察zoomRatio或linearZoom，它们也将获得更新。如果linearZoom不在[0…1]范围内，则返回ListenableFuture将失败 IllegalArgumentException并不会修改当前的linearZoom和zoomRatio。将linearZoom限制在[0…1]之内是应用程序的职责。

setZoomRatio: 按比例设置当前缩放。

它同时修改了当前的zoomRatio和linearZoom，因此，如果应用程序正在观察zoomRatio或linearZoom，它们也将获得更新。如果该比率小于ZoomState.getMinZoomRatio()或大于 ZoomState.getMaxZoomRatio()，则返回ListenableFuture将失败 IllegalArgumentException并不会修改当前的缩放比率。限制比率是应用程序的职责。

startFocusAndMetering:(重点）开始由配置的对焦和测光操作FocusMeteringAction。

它将触发自动对焦动作并启用AF / AE / AWB测光区域。该动作由进行配置，FocusMeteringAction其中包含多个AF / AE / AWB MeteringPoint的配置，自动取消持续时间。

一次只能FocusMeteringAction运行一个。如果FocusMeteringAction连续执行多个 ，则只能执行最新的操作，其他操作将被取消。

如果FocusMeteringAction指定的AF / AE / AWB点数多于当前设备支持的点数，则仅启用第一个点，然后依次启用设备支持的点数。

如果设备上不支持带有AF / AE / AWB的任何点，则返回的ListenableFuture输入 startFocusAndMetering(FocusMeteringAction)将立即失败。
之后在记载FocusMeteringAction的部分我会详细介绍相机对焦与测光的用法。

作者：Rookie泽