侧边栏壁纸
  • 累计撰写 416 篇文章
  • 累计创建 65 个标签
  • 累计收到 145 条评论

目 录CONTENT

文章目录

Android CameraX 知识点

Z同学
2022-10-01 / 0 评论 / 4 点赞 / 2,994 阅读 / 2,508 字
温馨提示:
本文最后更新于 2022-10-08,若内容或图片失效,请留言反馈。部分素材来自网络,若不小心影响到您的利益,请联系我们删除。

1. 前言

主要是CameraX中一些关键知识点的汇总介绍。并不会完整介绍CameraX的使用。

更多的是一些概念和注意点,以及名词介绍等内容。同时也有部分的api方法的简单介绍。

2 CameraX 和 Camera2的区别

Android 现在使用相机主要是通过CameraXCamera2。常见应用的开发使用CameraX库调用相机就可以了。

因为CameraXCamera2简单,简单,简单。 很多功能都直接封装到api里面了方便我们调用,同时兼容性也高。

CameraX是基于Camera2软件包构建的。如果要低级别(更底层)的相机控件来支持复杂用例。那么Camera2就是我们的最优选择。

原先使用相机,需要自己配置很多选项。并且要注意相机对象和预览数据的释放等,配置繁琐。而Google封装了Camera2,帮我们简化了很多相机的配置和管理,让开发者只需要关注预览,拍照,分析。等实际场景。将这一整套方法库封装成了CameraX,后来合并到Jetpack库中。

2.1 CameraX的特点:

总结一下CameraX的一些特点,一家之言。仅供参考。

  1. 支持Android API 21 及以上版本,覆盖现有Android设备的98%以上。(数据是官方提供的,更低版本不支持)
  2. 易用性高:直接处理封装了预览,图片分析,图片拍摄,视频拍摄。以上功能直接提供api方便操作。
  3. 兼容性强:不管什么设备,图片的宽高比,旋转角度,大小等全部封装统一了。
  4. 扩展性好:提供Extensions API可以实现与原生相机应用相同的特性和功能。

也就是我们可以不用管相机的配置和销毁。关注于相机输出的图片等数据。

3. CameraX 知识

我们常见的功能分为:

  • 预览: 将Camera拍摄的数据实时在app指定区域进行显示,使用PreviewView主要进行预览显示
  • 图片分析:将相机拍摄的图片进行数据分析,例如人脸识别,动作识别等都是需要相机拍摄的图片进行分析的。
  • 图片拍摄:这个功能主要就是存储,将预览显示的图片效果,进行本地存储。
  • 视频拍摄:主要通过VideoCapture类,将音视频数据进行存储。

我们app主要使用相机也是在这四个基本功能进行后续的业务实现。

而以上四个功能并不是必须按照顺序使用和调用的。他们都可以单独使用,例如我只需要图片分析,不需求其他功能等。

也可以全部组合使用,而常见的组合就是 预览+分析+拍摄了。

上面的功能就是用例了。而我们使用CameraX就是通过组合各种用例来达到要求了。

3.1 生命周期

CameraX在使用过程中,并不需要我们管理相机的生命周期,系统会自动帮助我们进行控制相机的打卡与关闭等。会基于当前页面的生命周期进行控制。是通过系统默认的LifecycleOwner进行控制的: 实例如下:通常this 是Activity或者Fragment

 cameraProvider.bindToLifecycle(this, cameraSelector, previewUseCase);

而如果我们想自己控制CameraX的生命周期那么可以通过自定义来实现了:

public class MyActivity extends Activity implements LifecycleOwner {
    private LifecycleRegistry lifecycleRegistry;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        lifecycleRegistry = new LifecycleRegistry(this);
        lifecycleRegistry.markState(Lifecycle.State.CREATED);
    }

    @Override
    public void onStart() {
        super.onStart();
        lifecycleRegistry.markState(Lifecycle.State.STARTED);
    }

    @NonNull
    @Override
    public Lifecycle getLifecycle() {
        return lifecycleRegistry;
    }
}

然后将bindToLifecycle中的 lifecycleOwner对象改为 我们自定义的lifecycleRegistry

3.2 设备等级

如果要同时支持预览+视频拍摄,那么相机都能支持。但是如果想预览+视频拍摄+图片拍摄,那么需要LIMITED以及更好的相机,

而预览+视频拍摄+分析 就需要LEVEL_3以及更好的相机。

因为很多设备前后双摄的性能是不一样的。所以有些功能后摄支持而前摄不支持。那么如何了解呢?

可以通过Camera2CameraInfo类来了解。

实例:以下代码可检查默认的后置摄像头是否是 LEVEL_3 设备:

@androidx.annotation.OptIn(markerClass = ExperimentalCamera2Interop.class)
Boolean isBackCameraLevel3Device(ProcessCameraProvider cameraProvider) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        List\ filteredCameraInfos = CameraSelector.DEFAULT_BACK_CAMERA
                .filter(cameraProvider.getAvailableCameraInfos());
        if (!filteredCameraInfos.isEmpty()) {
            return Objects.equals(
                Camera2CameraInfo.from(filteredCameraInfos.get(0)).getCameraCharacteristic(
                        CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL),
                CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3);
        }
    }
    return false;
}

等级范围为:LEGACY < LIMITED < FULL < LEVEL_3

如果我们使用的用例组合(预览+分析+拍照+录像),那么会在首次调用 createCaptureSession()出现异常。

3.3 选择摄像头

CameraX 会根据应用的要求和用例自动选择最佳摄像头设备。如果您希望使用的设备与系统为您选择的设备不同,有以下几种选项供您选择:

  • 使用 CameraSelector.DEFAULT_FRONT_CAMERA 请求默认的前置摄像头。
  • 使用 CameraSelector.DEFAULT_BACK_CAMERA请求默认的后置摄像头。
  • 使用 CameraSelector.Builder.addCameraFilter()CameraCharacteristics 过滤可用设备的列表。

所有的摄像头设备都必须经过系统识别,并显示在CameraManager.getCameraIdList()中才能被我们使用。

而这个识别过程,是设备厂商需要完成的工作。

CameraSelector cameraSelector =
        CameraSelector.Builder()
            .requireLensFacing(CameraSelector.LENS_FACING_BACK)
            .build()

然后将cameraSelector传给CameraProvider进行配置相机就可以了。

3.4 相机旋转角度

默认预览Preview获取到的角度就是已经执行了选择的,而ImageAnalysis图片分析和图片拍照ImageCapture没有,需要我们根据传递过来的imageProxy.getImageInfo().getRotationDegrees()进行处理。

例如ImageCapture可以直接执行旋转:

    ImageCapture imageCapture = new ImageCapture.Builder().build();

    OrientationEventListener orientationEventListener = new OrientationEventListener((Context)this) {
       @Override
       public void onOrientationChanged(int orientation) {
           int rotation;

           // Monitors orientation values to determine the target rotation value
           if (orientation >= 45 && orientation < 135) {
               rotation = Surface.ROTATION_270;
           } else if (orientation >= 135 && orientation < 225) {
               rotation = Surface.ROTATION_180;
           } else if (orientation >= 225 && orientation < 315) {
               rotation = Surface.ROTATION_90;
           } else {
               rotation = Surface.ROTATION_0;
           }

           imageCapture.setTargetRotation(rotation);
       }
    };

    orientationEventListener.enable();

3.5 分辨率

CameraX默认会使用系统最佳分辨率展示,而图片拍摄ImageCapture和图片分析ImageAnalysis模式下,默认会采用4:3的宽高比值 也就是640*480

CameraX会针对不同的用例匹配不同的分辨率。并不是全部一致的。默认情况下

预览模式:默认最高预览分辨率。照着屏蔽分辨率进行匹配的最佳尺寸。(可以调整)

分析模式:默认分辨率为640*480。(可以调整)

拍摄模式:默认最高可用分辨率,或与上述宽高比匹配的最高设备首选分辨率。

我们也可以通过setTargetResolution(Size resolution)指定特定的分辨率,进行分析拍摄。实例:

ImageAnalysis imageAnalysis =
  new ImageAnalysis.Builder()
    .setTargetResolution(new Size(1280, 720))
    .build();

上面是指定了分辨率,我们还可以通过指定宽高比来实现:setTargetAspectRatio

但是,这两个参数配置项不能同时设置,否则会出现IllegalArgumentException 异常。

也就是一个用例中不能给它设置宽高比的同时设置分辨率。

同时,可以通过StreamConfigurationMap.getOutputSizes(int)来查看当前设备支持的特点分辨率。

3.6 闪光灯

主要是拍照的时候回使用到闪光灯,而开启方法比较简单:

ImageCapture mImageCapture = new ImageCapture.Builder().setFlashMode(ImageCapture.FLASH_MODE_AUTO).build();

setFashMode :是否开启闪光灯,而主要有四种模式:

  • ImageCapture.FLASH_MODE_UNKNOWN:未知模式
  • ImageCapture.FLASH_MODE_AUTO:根据环境光感自动开启闪光灯
  • ImageCapture.FLASH_MODE_ON:每次都开启闪光灯
  • ImageCapture.FLASH_MODE_OFF:关闭闪光灯

3.7 相机控制

我们可以通过相机控制实现变焦,手电筒,对焦测光(点按对焦),曝光补偿

Camera camera = processCameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)

//可以配置常用的相机功能
CameraControl cameraControl = camera.getCameraControl()
// 可以查询这些常用相机功能的状态。
CameraInfo cameraInfo = camera.getCameraInfo()

变焦:CameraControl.setZoomRatio()用于按变焦比例设置变焦,CameraControl.setZoomRatio()用于0到1.0之间的线性变焦。

手电筒:CameraControl.enableTorch(boolean) 可以启用或停用手电筒(也称为手电)。

对焦:CameraControl.startFocusAndMetering() 可根据指定的 FocusMeteringAction 设置 AF/AE/AWB 测光区域,以触发自动对焦和曝光测光。有许多相机应用通过这种方式实现“点按即可对焦”功能。

3.8 VideoCapture

主要是相机录制视频的配置,其他都大同小异,主要介绍一些常见配置项:

VideoCapture mVideoCapture = new VideoCapture.Builder().build();//用于录制视频
processCameraProvider.bindToLifecycle(this, mCameraSelector, mVideoCapture, mPreview);

我们在VideoCapture进行build之前可以配置以下选项:

        VideoCapture capture= new VideoCapture.Builder()
                .setVideoFrameRate()
                .setBitRate()
                .setAudioBitRate()
                ...
                .build()
  • setVideoFrameRate():帧率,默认为30;
  • setBitRate():比特率,默认为8 * 1024 * 1024;
  • setIFrameInterval():帧间隔,默认1;
  • setAudioBitRate():音频比特率,默认为64000;
  • setAudioSampleRate():音频采集频率,默认8000;
  • setAudioChannelCount():音频通道数,默认1;
  • setAudioMinBufferSize():音频最小缓存大小,默认为1024;
  • setMaxResolution():最大分辨率,默认为1920, 1080
  • setTargetAspectRatio():宽高比,默认为16:9;

参考资料:
https://developer.android.google.cn/training/camerax

https://developer.android.google.cn/reference/android/hardware/camera2/CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL (相机的参考等级)

4

评论区