前面讲了,camera1和camera2的简单使用。从前文可以看出来,API 的调用还是比较繁琐的,而且像一些最佳尺寸,角度等还得自己算。由于camera1支持的特性很少,camera2流程又很繁琐,google 也意识到这个问题,所以推出了 Camerax。它虽然底层也是利用了 Camera2 的功能,但它的使用却更加简洁,它的主要优势如下:

  • 更加简洁的 API 调用,基本十几行代码就能实现预览
  • Camerax 为 Jetpack 的支持库,所以也具备感知生命周期的功能,即你无需自己释放 生命周期
  • 更好兼容性
  • 更多功能,比如图片分析等

注意,Camerax 也只支持 API21 及以上。

本文也仅展示怎么预览和拍照,其他功能可以参照Android开发者官网。代码非常简单,如下:

首先,添加关联库:

def camerax_version = "1.0.0-beta06"
// CameraX 核心库
implementation "androidx.camera:camera-camera2:$camerax_version"
// CameraX 生命周期
implementation "androidx.camera:camera-lifecycle:$camerax_version"
// CameraX view 集合,比如 cameraview,preview等
implementation "androidx.camera:camera-view:1.0.0-alpha10"

权限

<uses-permission android:name="android.permission.CAMERA" /> 
 <uses-feature android:name="android.hardware.camera.any" />

预览

 xml布局:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".FullScreenClipActivity">
    <androidx.camera.view.PreviewView
        android:id="@+id/pv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</RelativeLayout>

通过

ListenableFuture<ProcessCameraProvider> cameraProviderFuture = ProcessCameraProvider.getInstance(this);

返回当前可以绑定生命周期的 ProcessCameraProvider,ProcessCameraProvider 它会和宿主绑定生命周期,这样就不用担心打开相机和关闭的问题了。

接着,向 cameraProviderFuture 注册一个监听,第一个参数是一个 runnable,第二个参数是线程池,即runnable 运行在哪个线程中:

cameraProviderFuture.addListener(Runnable {}, ContextCompat.getMainExecutor(this))

上面我们让它运行在主线程的线程池中,这样,在这个 runnable 中,就可以配置我们的 capture 了,代码如下:

mViewFinder = findViewById(R.id.pv);
        //创建相机进程监听
        ListenableFuture<ProcessCameraProvider> cameraProviderFuture = ProcessCameraProvider.getInstance(this);
        cameraProviderFuture.addListener(new Runnable() {
            @SuppressLint("RestrictedApi")
            @Override
            public void run() {
                try {
                    //将相机的生命周期和activity的生命周期绑定,camerax 会自己释放,不用担心了
                    ProcessCameraProvider cameraProvider = cameraProviderFuture.get();
                    //预览的 capture,它里面支持角度换算
                    Preview preview = new Preview.Builder().build();

                    //创建图片的 capture
                    mImageCapture = new ImageCapture.Builder()
                            .setFlashMode(ImageCapture.FLASH_MODE_AUTO)
                            .build();

                   
                    //选择后置摄像头
                    CameraSelector cameraSelector = new CameraSelector.Builder().requireLensFacing(CameraSelector.LENS_FACING_BACK).build();

                    //预览之前先解绑
                    cameraProvider.unbindAll();

                    //将数据绑定到相机的生命周期中
                    Camera camera = cameraProvider.bindToLifecycle(CameraxActivity.this, cameraSelector, preview, mImageCapture);
                    //将previewview 的 surface 给相机预览
                    preview.setSurfaceProvider(mViewFinder.createSurfaceProvider(camera.getCameraInfo()));

                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        },ContextCompat.getMainExecutor(this));

创建并确认 CameraProvider 后,执行步骤如下

  • 创建 Preview,使用 new Preview.Builder().build() 创建Preview,它是相机预览的数据流,图像数据会通过它来输出,比如输出到 Surface 中
  • 创建 ImageCapture 用于拍照,这里的 builder 都可以设置参数,比如大小,曝光等
  • 指定所需的相机 LensFacing 选项,这里直接使用后置即可
  • 将所选相机和任意用例绑定到生命周期,通过 cameraProvider.bindToLifecycle,将宿主的生命周期,与 cameraSelector,preview和mImageCapture判定起来。
  • 将 Preview 连接到 PreviewView,preview.setSurfaceProvider() 设置要预览的 surface

拍照

上面已经设置了 mImageCapture,拍照在 Camerax 中也很简单,使用 takePicture 即可,如下

public void takePhoto(View view) {
        if (mImageCapture != null) {
            File dir = new File(Constants.PATH);
            if (!dir.exists()) {
                dir.mkdirs();
            }
            //创建文件
            File file = new File(Constants.PATH,"testx.jpg");
            if (file.exists()) {
                file.delete();
            }
            //创建包文件的数据,比如创建文件
            ImageCapture.OutputFileOptions outputFileOptions = new ImageCapture.OutputFileOptions.Builder(file).build();

            //开始拍照
            mImageCapture.takePicture(outputFileOptions, ContextCompat.getMainExecutor(this), new ImageCapture.OnImageSavedCallback() {
                @Override
                public void onImageSaved(@NonNull ImageCapture.OutputFileResults outputFileResults) {
                //    Uri savedUri = outputFileResults.getSavedUri();
                    Toast.makeText(CameraxActivity.this, "保存成功: ", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onError(@NonNull ImageCaptureException exception) {
                    Toast.makeText(CameraxActivity.this, "保存失败", Toast.LENGTH_SHORT).show();
                }
            });
        }
    }

注释已经很清楚了,注意我们可以使用 ImageCapture.OutputFileOptions 让 Camerax 去帮我们保存图片文件。