如何使用CameraX API实现1.0倍以下广角变焦？

不需要切换到Camera2，CameraX完全支持访问广角镜头并实现1.0倍以下的缩小变焦。你之前遇到addCameraFilter未执行的问题，大概率是实现逻辑或版本适配的问题，以下是具体解决步骤：

一、先确认设备硬件支持 #

首先要确保你的测试设备确实配备广角镜头——不是所有安卓设备都有广角模组。可以通过CameraX查询所有后置镜头的参数：

val cameraProviderFuture = ProcessCameraProvider.getInstance(context)
cameraProviderFuture.addListener({
    val cameraProvider = cameraProviderFuture.get()
    // 获取所有后置摄像头
    val allBackCameras = cameraProvider.availableCameraInfos.filter {
        it.lensFacing == CameraSelector.LENS_FACING_BACK
    }
    // 遍历检查每个镜头的最小缩放比（广角镜头最小缩放比通常<1.0）
    allBackCameras.forEach { info ->
        val zoomState = info.zoomState.value
        zoomState?.let {
            Log.d("CameraInfo", "最小缩放比: ${it.minZoomRatio}, 最大缩放比: ${it.maxZoomRatio}")
        }
    }
}, ContextCompat.getMainExecutor(context))

如果输出的最小缩放比小于1.0，说明设备有支持缩小变焦的广角镜头。

二、正确筛选广角镜头 #

之前的addCameraFilter未执行，可能是CameraSelector的构建逻辑有问题，或是使用的CameraX版本过低（建议升级到1.3.0及以上）。以下是可靠的广角镜头选择方案：

fun buildWideAngleCameraSelector(): CameraSelector {
    return CameraSelector.Builder().apply {
        requireLensFacing(CameraSelector.LENS_FACING_BACK)
        addCameraFilter { cameraInfos ->
            // 筛选出最小缩放比<1.0的后置镜头（广角镜头）
            cameraInfos.filter { info ->
                val zoomState = info.zoomState.value
                zoomState?.minZoomRatio ?: Float.MAX_VALUE < 1.0f
            }
        }
    }.build()
}

调用此方法获取CameraSelector后，绑定CameraX的UseCases（Preview、ImageCapture等）即可。

三、实现1.0倍以下变焦控制 #

绑定广角镜头后，就可以通过UseCases的setZoomRatio方法设置小于1.0的缩放值：

// 假设已初始化previewUseCase和cameraControl
val targetZoom = 0.8f // 0.8倍广角变焦
cameraControl.setZoomRatio(targetZoom).addListener({
    // 变焦完成后的回调
}, ContextCompat.getMainExecutor(context))

// 也可以监听ZoomState变化，获取当前支持的缩放范围
previewUseCase.cameraInfo.zoomState.observe(lifecycleOwner) { zoomState ->
    val minZoom = zoomState.minZoomRatio
    val maxZoom = zoomState.maxZoomRatio
    // 更新UI的变焦滑块范围，比如设置滑块最小值为minZoom
}

常见问题排查 #

1. addCameraFilter未执行：检查CameraX版本是否为1.3.0+，旧版本可能对CameraFilter支持不完善；同时确保availableCameraInfos中有符合条件的镜头，否则过滤器不会触发有效筛选。
2. 变焦无效果：确认绑定的是筛选后的广角镜头，而非默认后置镜头；有些设备的广角镜头仅在特定分辨率下支持，可尝试调整Preview的分辨率配置。

内容的提问来源于stack exchange，提问作者Droid