CameraX自动对焦指示器位置异常问题排查及代码咨询

我最近在开发CameraX的Compose页面时遇到了一个问题：当用户点击相机预览画面时，自动对焦指示器显示的位置和实际点击的位置不匹配。经过调试发现，onTap回调里获取的Offset坐标好像有问题，同时也想请大家帮忙检查下我的CameraManager类（负责处理所有相机相关逻辑）有没有潜在问题（暂时没贴出这个类的代码，后面会说明相关排查点）。先贴出我的CameraScreen Composable代码：

@Composable
fun CameraScreen(
    modifier: Modifier = Modifier,
    permissionStatus: Boolean?,
    state: CameraState,
    onEvent: (CameraEvent) -> Unit = {},
    viewModel: CameraViewModel = hiltViewModel<CameraViewModel>(),
    onNavigateToImageEdit : (AppScreen.MediaEdit) -> Unit
) {
    val context = LocalContext.current
    val app = context.applicationContext
    val lifecycleOwner = LocalLifecycleOwner.current
    var showImagePreview by remember { mutableStateOf(false) }
    val imageUri by viewModel.capturedImageUri.collectAsStateWithLifecycle()
    var co by remember { mutableStateOf(Offset(0f,0f)) }

    val mediaLauncher = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.PickVisualMedia()
    ) { uri ->
        if (uri!=null){
            Log.d("CameraScreen", "Camera Screen content uri : ${uri.toString()} ")
            onNavigateToImageEdit(AppScreen.MediaEdit(uri.toString()))
        }
    }

    LaunchedEffect(Unit) {
        viewModel.errorFlow.collect { message ->
            Log.e(TAG, "CameraScreen: error while capturing $message")
        }
    }

    val coordinateTransformer = remember { MutableCoordinateTransformer() }
    var autofocusRequest by remember { mutableStateOf(UUID.randomUUID() to Offset.Unspecified) }
    val autofocusRequestId = autofocusRequest.first
    // Show the autofocus indicator if the offset is specified
    var showAutofocusIndicator = autofocusRequest.second.isSpecified
    // Cache the initial coords for each autofocus request
    val autofocusCoords = remember(autofocusRequestId) { autofocusRequest.second }

    // Queue hiding the request for each unique autofocus tap
    if (showAutofocusIndicator) {
        LaunchedEffect(autofocusRequestId) {
            delay(2000)
            autofocusRequest = autofocusRequestId to Offset.Unspecified
        }
    }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.Black)
        ,
    ) {
        Log.d(TAG, "CameraScreen: permissionStatus = ${permissionStatus} ")
        if (permissionStatus != null && !permissionStatus) {
            Text(
                text = "Camera permission has not been granted",
                modifier = Modifier.align(Alignment.Center)
            )
        }

        if (permissionStatus != null && permissionStatus) {
            Text(
                text = "Camera",
                modifier = Modifier.align(Alignment.Center)
            )
        }

        state.surfaceRequest?.let { surfaceRequest ->
            CameraXViewfinder(
                surfaceRequest = surfaceRequest,
                coordinateTransformer = coordinateTransformer,
                modifier = Modifier
                    .align(Alignment.Center)
                    .fillMaxWidth()
                    .aspectRatio(state.aspectRatio.ratio)
                    .pointerInput(Unit) {
                        detectTapGestures(
                            onDoubleTap = { tapCoords ->
                                onEvent(CameraEvent.ChangeLensFacing)
                            },
                            onTap = {offset ->
                                co = offset
                                with(coordinateTransformer){
                                    onEvent(CameraEvent.TapToFocus(offset.transform()))
                                }
                                autofocusRequest = UUID.randomUUID() to offset
                            }
                        )
                    }
            )

            AnimatedVisibility(
                visible = showAutofocusIndicator,
                enter = fadeIn(),
                exit = fadeOut(),
                modifier = Modifier
            ) {
                Spacer(
                    Modifier
                        .offset { autofocusCoords.takeOrElse { Offset.Zero }.round() }
                        .offset((-24).dp, (-24).dp)
                        .border(1.dp, Color.White, CircleShape)
                        .size(48.dp)
                )
            }
        }

        UpperBox(
            modifier = Modifier.align(Alignment.TopEnd),
            torchState = state.torchState,
            onTorchToggle = { onEvent(CameraEvent.TorchToggle) },
            onAspectRatioChange = { onEvent(CameraEvent.ToggleAspectRatio) }
        )

        LowerBox(
            modifier = Modifier
                .align(Alignment.BottomCenter),
            onToggleCamera = { onEvent(CameraEvent.ChangeLensFacing) },
            onChooseFromGallery = {
                mediaLauncher.launch(
                    PickVisualMediaRequest(
                        ActivityResultContracts.PickVisualMedia.ImageOnly
                    )
                )
            },
            onClick = {
                val file = createTempFile(
                    context
                )
                onEvent(CameraEvent.TakePicture(file))
            }
        )

        // tap indicator for debugging
        Surface(
            modifier = Modifier
                .offset{co.round()}
                .height(10.dp).width(10.dp)
                .background(Color.White)
        ) {
        }
    }

    LaunchedEffect(imageUri) {
        if(imageUri!=null){
            onNavigateToImageEdit(AppScreen.MediaEdit(imageUri.toString()))
            onEvent(CameraEvent.Reset)
        }
    }

    LaunchedEffect(lifecycleOwner, state.lensFacing,state.aspectRatio) {
        lifecycleOwner.lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
            onEvent(CameraEvent.Preview(app, lifecycleOwner))
        }
    }
}

问题分析与解决方案 #

1. 对焦指示器位置偏移的核心原因 #

点击事件获取的Offset是Compose布局坐标系的坐标，但CameraX的预览画面会因为宽高比适配、镜头方向（前后置）、设备旋转等因素发生坐标系变换，直接用原始Offset显示指示器或处理对焦，会导致位置不匹配。

2. 代码里的具体问题点 #

• 坐标转换不统一：你在处理对焦请求时调用了offset.transform()（通过coordinateTransformer转换到CameraX预览坐标系），但存储用于显示指示器的autofocusCoords时用的是原始的未转换Offset，这就导致指示器用的是布局坐标系，而实际点击的预览位置是转换后的，两者自然不匹配。
• 硬编码偏移适配错误：指示器设置了(-24).dp的额外偏移，虽然是为了让指示器中心对齐点击点，但这个偏移是基于dp的硬编码，没有结合设备像素密度转换，而且在原始坐标错误的前提下，会进一步加剧位置偏差。
• 调试指示器未同步转换：用于调试的白色小方块（Surface）用的是原始的co变量（未转换的Offset），所以它的位置也和预览画面的实际点击位置不符，这也验证了坐标转换的问题。

3. 针对性修复方案 #

（1）统一坐标转换逻辑

在onTap回调里，先将原始Offset转换为CameraX预览坐标系的坐标，再同时用于对焦请求和指示器位置存储：

onTap = { offset ->
    // 转换为CameraX预览坐标系的坐标
    val transformedOffset = with(coordinateTransformer) { offset.transform() }
    co = transformedOffset // 调试用的方块也同步用转换后的坐标
    onEvent(CameraEvent.TapToFocus(transformedOffset))
    // 存储转换后的坐标用于显示指示器
    autofocusRequest = UUID.randomUUID() to transformedOffset
}

（2）正确计算指示器的中心偏移

将硬编码的(-24).dp偏移改为基于像素的动态计算，确保指示器中心对齐点击点：

val indicatorSize = 48.dp.toPx() // 先将dp转换为像素值
AnimatedVisibility(
    visible = showAutofocusIndicator,
    enter = fadeIn(),
    exit = fadeOut()
) {
    Spacer(
        Modifier
            .offset { autofocusCoords.takeOrElse { Offset.Zero }.round() }
            // 让指示器中心对准点击点：偏移量为负的一半大小
            .offset(x = -indicatorSize / 2, y = -indicatorSize / 2)
            .border(1.dp, Color.White, CircleShape)
            .size(indicatorSize)
    )
}

（3）确保CoordinateTransformer正确绑定预览用例

MutableCoordinateTransformer需要和CameraX的Preview用例绑定，才能正确完成坐标系转换。如果你的CameraManager类负责创建Preview用例，需要在初始化时添加绑定逻辑：

// 假设在CameraManager的预览初始化逻辑中
val preview = Preview.Builder()
    .setTargetAspectRatio(state.aspectRatio)
    .build()

// 将CoordinateTransformer与Preview用例绑定
coordinateTransformer.setPreview(preview)

// 绑定到相机生命周期
preview.setSurfaceProvider(
    cameraProvider.bindToLifecycle(
        lifecycleOwner,
        state.lensFacing,
        preview
    )
)

4. 关于CameraManager类的排查建议 #

因为你没有贴出CameraManager的代码，这里给出几个关键排查点：

• 对焦请求的坐标处理：在处理CameraEvent.TapToFocus事件时，是否将转换后的Offset正确转换为CameraX的MeteringPoint？正确的逻辑应该是：

  // 假设已经获取到Preview用例的MeteringPointFactory
  val meteringPoint = meteringPointFactory.createPoint(transformedOffset.x, transformedOffset.y)
  val action = FocusMeteringAction.Builder(meteringPoint).build()
  camera.cameraControl.startFocusAndMetering(action)
  

• 设备旋转适配：是否处理了设备旋转导致的预览坐标系变化？CameraX会自动处理旋转，但如果CameraManager里有自定义的坐标逻辑，需要确保同步旋转参数。
• 镜头方向适配：前后置镜头的预览画面是镜像的，是否在坐标转换时考虑了这个因素？

内容来源于stack exchange