Android CameraX 使用指南及一些高級功能(簡化相機開發(fā))

更新時間：2025年07月28日 10:12:08 作者：安卓開發(fā)者

CameraX簡化Android相機開發(fā),解決兼容性、生命周期與API復雜性問題,支持圖像分析、拍照及設備特性檢查,通過最佳實踐,開發(fā)者可高效實現(xiàn)高質(zhì)量相機功能,專注業(yè)務邏輯,本文給大家介紹Android CameraX 使用指南及一些高級功能,感興趣的朋友一起看看吧

前言

在Android開發(fā)中，相機功能一直是比較復雜的部分，需要處理不同設備的兼容性、生命周期管理以及復雜的API調(diào)用。Google推出的CameraX庫極大地簡化了這一過程，讓開發(fā)者能夠更輕松地實現(xiàn)高質(zhì)量的相機功能。本文將帶你全面了解CameraX的使用方法。

什么是CameraX？

CameraX是Jetpack系列中的一個庫，它基于Camera2 API構(gòu)建，但提供了更高層次的抽象，具有以下優(yōu)點：

簡化API：比Camera2 API更易于使用
生命周期感知：自動管理相機生命周期
設備兼容性：處理不同廠商設備的兼容性問題
一致的行為：在不同設備上提供更一致的體驗

添加依賴

首先，在build.gradle文件中添加CameraX依賴：

def camerax_version = "1.3.0"
implementation "androidx.camera:camera-core:${camerax_version}"
implementation "androidx.camera:camera-camera2:${camerax_version}"
implementation "androidx.camera:camera-lifecycle:${camerax_version}"
implementation "androidx.camera:camera-view:${camerax_version}"

基本使用流程

1. 請求相機權(quán)限

在AndroidManifest.xml中添加權(quán)限聲明：

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

運行時請求權(quán)限：

private val requestPermissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { isGranted ->
    if (isGranted) {
        startCamera()
    } else {
        Toast.makeText(this, "Permission denied", Toast.LENGTH_SHORT).show()
    }
}
// 檢查并請求權(quán)限
if (ContextCompat.checkSelfPermission(
        this, Manifest.permission.CAMERA
    ) == PackageManager.PERMISSION_GRANTED
) {
    startCamera()
} else {
    requestPermissionLauncher.launch(Manifest.permission.CAMERA)
}

2. 配置預覽視圖

在布局文件中添加PreviewView：

<androidx.camera.view.PreviewView
    android:id="@+id/viewFinder"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

3. 初始化CameraX

private fun startCamera() {
    val cameraProviderFuture = ProcessCameraProvider.getInstance(this)
    cameraProviderFuture.addListener({
        // 用于綁定相機生命周期
        val cameraProvider: ProcessCameraProvider = cameraProviderFuture.get()
        // 預覽
        val preview = Preview.Builder()
            .build()
            .also {
                it.setSurfaceProvider(viewFinder.surfaceProvider)
            }
        // 選擇后置攝像頭
        val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
        try {
            // 解綁之前的所有用例
            cameraProvider.unbindAll()
            // 綁定用例到生命周期
            cameraProvider.bindToLifecycle(
                this, cameraSelector, preview
            )
        } catch(exc: Exception) {
            Log.e(TAG, "Use case binding failed", exc)
        }
    }, ContextCompat.getMainExecutor(this))
}

高級功能

圖像分析

CameraX可以輕松實現(xiàn)圖像分析：

val imageAnalysis = ImageAnalysis.Builder()
    .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
    .build()
imageAnalysis.setAnalyzer(executor) { imageProxy ->
    // 在這里處理圖像
    val rotationDegrees = imageProxy.imageInfo.rotationDegrees
    // 處理完成后關閉imageProxy
    imageProxy.close()
}
// 記得在bindToLifecycle中添加這個用例
cameraProvider.bindToLifecycle(
    this, cameraSelector, preview, imageAnalysis
)

拍照功能

private fun takePhoto() {
    // 創(chuàng)建圖片捕獲用例
    val imageCapture = ImageCapture.Builder()
        .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
        .build()
    // 綁定用例
    cameraProvider.bindToLifecycle(
        this, cameraSelector, preview, imageCapture
    )
    // 創(chuàng)建輸出選項
    val outputOptions = ImageCapture.OutputFileOptions.Builder(
        File(externalMediaDirs.first(), "${System.currentTimeMillis()}.jpg")
    ).build()
    // 拍照
    imageCapture.takePicture(
        outputOptions,
        ContextCompat.getMainExecutor(this),
        object : ImageCapture.OnImageSavedCallback {
            override fun onError(exc: ImageCaptureException) {
                Log.e(TAG, "Photo capture failed: ${exc.message}", exc)
            }
            override fun onImageSaved(output: ImageCapture.OutputFileResults) {
                val savedUri = output.savedUri ?: Uri.fromFile(outputOptions.outputFile)
                Log.d(TAG, "Photo capture succeeded: $savedUri")
            }
        }
    )
}

處理設備特性

CameraX提供了簡單的方式來檢查設備支持的功能：

val cameraInfo = cameraProvider.availableCameraInfos.find {
    it.cameraSelector == cameraSelector
}
// 檢查閃光燈支持
val hasFlash = cameraInfo?.torchState?.value != null
// 檢查變焦支持
val hasZoom = cameraInfo?.zoomState?.value != null