CameraX：在Android中轻松实现拍照和录像

2023-09-24 12:13:23

引言

在 Android 中，相机是一个非常重要的功能。它可以用于拍照、录像、扫描二维码等。在过去的几年中，Android 的相机 API 经历了几次重大变化。CameraX 是 Google 在 2019 年发布的一个新的相机 API，它旨在简化相机应用的开发工作。

CameraX 提供了一致且易用的 API 接口，适用于大多数 Android 设备，并可向后兼容至 Android 5.0。这使得开发人员可以更轻松地创建跨设备兼容的相机应用。

在本文中，我将向您展示如何在 Android 中使用 Kotlin 实现 CameraX 拍照和录像。在此过程中，您将学习如何设置 CameraX、使用 CameraX 的生命周期回调函数、请求相机权限以及使用 CameraX 拍照和录像。

设置 CameraX

首先，您需要在项目中添加 CameraX 库。您可以在项目的 build.gradle 文件中添加以下代码来添加 CameraX 库：

implementation "androidx.camera:camera-core:1.1.0"
implementation "androidx.camera:camera-camera2:1.1.0"
implementation "androidx.camera:camera-lifecycle:1.1.0"
implementation "androidx.camera:camera-view:1.1.0"

添加完 CameraX 库后，您需要在 AndroidManifest.xml 文件中添加以下代码来请求相机权限：

<uses-permission android:name="android.permission.CAMERA" />

接下来，您需要在您的 Activity 或 Fragment 中设置 CameraX。您可以通过以下代码来设置 CameraX：

val cameraProviderFuture = ProcessCameraProvider.getInstance(this)
cameraProviderFuture.addListener({
    cameraProvider = cameraProviderFuture.get()
}, ContextCompat.getMainExecutor(this))

在上述代码中，cameraProviderFuture 是一个 Future 对象，它将在相机提供程序可用时完成。当相机提供程序可用时，您可以通过 cameraProviderFuture.get() 方法获取相机提供程序。

使用 CameraX 的生命周期回调函数

CameraX 提供了三个生命周期回调函数，分别是 onAttachedToWindow()、onDetachedFromWindow() 和 onSurfaceTextureAvailable()。这些回调函数可以用于在相机预览开始或结束时执行一些操作。

您可以通过以下代码来使用 CameraX 的生命周期回调函数：

override fun onAttachedToWindow() {
    super.onAttachedToWindow()

    // CameraX 预览开始
    cameraProvider.bindToLifecycle(this)
}

override fun onDetachedFromWindow() {
    super.onDetachedFromWindow()

    // CameraX 预览结束
    cameraProvider.unbindAll()
}

override fun onSurfaceTextureAvailable(surfaceTexture: SurfaceTexture, width: Int, height: Int) {
    super.onSurfaceTextureAvailable(surfaceTexture, width, height)

    // CameraX 预览可用
    val previewConfig = PreviewConfig.Builder().build()
    val preview = Preview(previewConfig)

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

    cameraProvider.bindToLifecycle(this, cameraSelector, preview)
}

请求相机权限

在使用 CameraX 之前，您需要请求相机权限。您可以通过以下代码来请求相机权限：

ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_CODE_CAMERA)

在上述代码中，REQUEST_CODE_CAMERA 是一个请求码，您可以在 onRequestPermissionsResult() 方法中使用它来检查用户是否授予了相机权限。

使用 CameraX 拍照

要使用 CameraX 拍照，您可以通过以下代码来创建拍照请求：

val imageCaptureConfig = ImageCaptureConfig.Builder().build()
val imageCapture = ImageCapture(imageCaptureConfig)

cameraProvider.bindToLifecycle(this, cameraSelector, imageCapture)

在上述代码中，imageCaptureConfig 是一个 ImageCaptureConfig 对象，它用于配置拍照请求。imageCapture 是一个 ImageCapture 对象，它可以用于捕获图像。

您可以通过以下代码来捕获图像：

imageCapture.takePicture(ContextCompat.getMainExecutor(this), object : ImageCapture.OnImageCapturedCallback() {
    override fun onCaptureSuccess(image: ImageProxy) {
        // 拍摄成功
    }

    override fun onError(error: ImageCaptureException) {
        // 拍摄失败
    }
})

使用 CameraX 录像

要使用 CameraX 录像，您可以通过以下代码来创建录像请求：

val videoCaptureConfig = VideoCaptureConfig.Builder().build()
val videoCapture = VideoCapture(videoCaptureConfig)

cameraProvider.bindToLifecycle(this, cameraSelector, videoCapture)

在上述代码中，videoCaptureConfig 是一个 VideoCaptureConfig 对象，它用于配置录像请求。videoCapture 是一个 VideoCapture 对象，它可以用于录制视频。

您可以通过以下代码来录制视频：

videoCapture.startRecording(ContextCompat.getMainExecutor(this), object : VideoCapture.OnVideoSavedCallback() {
    override fun onVideoSaved(outputFile: File) {
        // 录制成功
    }

    override fun onError(videoCaptureError: VideoCaptureException) {
        // 录制失败
    }
})