如何通过Kotlin代码检测Android设备是否配备微距摄像头

问题背景 #

需要通过编程检测Android智能手机是否配备物理微距摄像头，尝试过利用CameraManager读取摄像头硬件等级、自动对焦模式、最小对焦距离、焦距等参数，但现有方案无法可靠判断，尝试的代码如下：

val cameraManager =  context?.getSystemService(Context.CAMERA_SERVICE) as? CameraManager

cameraManager?.cameraIdList?.forEach { cameraId ->
    val characteristics = cameraManager.getCameraCharacteristics(cameraId)
    val lensFacing = characteristics.get(CameraCharacteristics.LENS_FACING)
    val capabilities =
        characteristics.get(CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL)
    capabilities?.let {
        Log.d("macroCameraLog_2", "isMacroCameraSupported: CAMERA_ID $cameraId")
        Log.d("macroCameraLog_2", "isMacroCameraSupported: HARD_WARE_LEVEL $it")
        if (it >= CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3) {
            Log.d("macroCameraLog_2", "isMacroCameraSupported: TRUE")
        }
    }

val afModes = characteristics.get(CameraCharacteristics.CONTROL_AF_AVAILABLE_MODES)
    afModes?.let { modes ->
        Log.d("macroCameraLog_3", "isMacroCameraSupported: CAMERA_ID $cameraId")
        Log.d(
            "macroCameraLog_3",
            "isMacroCameraSupported: MODES ${formatCharacteristicValue(modes)}"
        )
        if (modes.contains(CameraMetadata.CONTROL_AF_MODE_MACRO)) {
            Log.d("macroCameraLog_3", "Macro AF mode is supported")
        }

        if (modes.contains(CameraMetadata.CONTROL_AF_MODE_CONTINUOUS_PICTURE)) {
            Log.d("macroCameraLog_3", "CONTROL_Macro AF mode is supported")
        }
    }

    if (lensFacing == CameraCharacteristics.LENS_FACING_BACK) {
        // Get the minimum focus distance
        val minFocusDistance =
            characteristics.get(CameraCharacteristics.LENS_INFO_MINIMUM_FOCUS_DISTANCE)
                ?: return false
        Log.d(
            "macroCameraLog",
            "isMacroCameraSupported: Min_Focus -> $minFocusDistance"
        )
        Log.d("macroCameraLog", "isMacroCameraSupported: Camera_ID -> $cameraId")
        // Define a threshold for macro capability (e.g., less than or equal to 0.05 meters or 5 cm)
        if (minFocusDistance in 0.01..0.05) {
            Log.d(
                "macroCameraLog",
                "isMacroCameraSupported: Min_Focus -> $minFocusDistance"
            )
            Log.d("macroCameraLog", "isMacroCameraSupported: Camera_ID -> $cameraId")
        }
    }
    // Check if it's a rear camera
    if (lensFacing == CameraCharacteristics.LENS_FACING_BACK) {
        // Check for physical cameras in a multi-camera system
        val physicalCameraIds = characteristics.physicalCameraIds
        if (physicalCameraIds.isNotEmpty()) {
            for (physicalCameraId in physicalCameraIds) {
                val physicalCharacteristics =
                    cameraManager.getCameraCharacteristics(physicalCameraId)
                val physicalFocalLengths =
                    physicalCharacteristics.get(CameraCharacteristics.LENS_INFO_AVAILABLE_FOCAL_LENGTHS)

                val minFocusDistance =
                    physicalCharacteristics.get(CameraCharacteristics.LENS_INFO_MINIMUM_FOCUS_DISTANCE)
                        ?: return false

                // Define a threshold for macro capability (e.g., less than or equal to 0.05 meters or 5 cm)
                Log.d(
                    "macroCameraLog",
                    "Physical_isMacroCameraSupported: Camera_ID -> $cameraId"
                )
                Log.d(
                    "macroCameraLog",
                    "Physical_isMacroCameraSupported: Min_Focus -> $minFocusDistance"
                )
                if (minFocusDistance in 0.01..0.05) {
                    Log.d(
                        "macroCameraLog",
                        "Physical_isMacroCameraSupported: Min_Focus -> $minFocusDistance"
                    )
                    Log.d(
                        "macroCameraLog",
                        "Physical_isMacroCameraSupported: Camera_ID -> $cameraId"
                    )
                }

                physicalFocalLengths?.let { focalLengths ->
                    for (focalLength in focalLengths) {
                        // Check for macro lens characteristics
                        if (focalLength in 1.0..2.0) {
                            // Macro lens found in a multi-camera system
                            // return true
                        }
                    }
                }
            }
        }
    }
}

现有方案的不足 #

1. 硬件等级判断太宽泛：INFO_SUPPORTED_HARDWARE_LEVEL_3仅代表摄像头支持高级特性，不直接关联微距能力，大部分中高端设备都满足，但不一定有微距镜头。
2. AF模式不可靠：CONTROL_AF_MODE_MACRO可能是软件模拟的微距（通过裁剪画面实现），并非物理微距镜头的标志。
3. 阈值设定过于绝对：不同厂商对最小对焦距离的标定存在差异，固定0.01-0.05m的范围会漏判部分设备。
4. 多摄像头逻辑不严谨：遍历物理摄像头时未明确区分主镜头与微距镜头，容易混淆判断。

可靠检测方案 #

要准确判断物理微距摄像头，需优先检查物理摄像头的硬件参数组合，而非单一指标：

• 最小对焦距离：物理微距镜头的最小对焦距离通常≤0.1米（远小于普通后置镜头的0.2米阈值）
• 物理焦距：微距镜头的物理焦距一般在1.0-3.0mm之间（普通主镜头焦距多在4-6mm）
• 排除软件微距：如果仅支持CONTROL_AF_MODE_MACRO但硬件参数不达标，判定为伪微距

改进后的代码实现 #

fun hasPhysicalMacroCamera(context: Context): Boolean {
    val cameraManager = context.getSystemService(Context.CAMERA_SERVICE) as? CameraManager ?: return false

    cameraManager.cameraIdList.forEach { cameraId ->
        val characteristics = cameraManager.getCameraCharacteristics(cameraId)
        val lensFacing = characteristics.get(CameraCharacteristics.LENS_FACING)
        // 只检查后置摄像头
        if (lensFacing != CameraCharacteristics.LENS_FACING_BACK) return@forEach

        // 处理多摄像头系统，直接遍历物理摄像头
        val physicalCameraIds = characteristics.physicalCameraIds
        val targetCameraIds = if (physicalCameraIds.isNotEmpty()) physicalCameraIds else listOf(cameraId)

        targetCameraIds.forEach { targetId ->
            val physicalCharacteristics = cameraManager.getCameraCharacteristics(targetId)
            // 获取最小对焦距离（单位：米）
            val minFocusDistance = physicalCharacteristics.get(CameraCharacteristics.LENS_INFO_MINIMUM_FOCUS_DISTANCE) ?: return@forEach
            // 获取物理焦距（单位：毫米）
            val focalLengths = physicalCharacteristics.get(CameraCharacteristics.LENS_INFO_AVAILABLE_FOCAL_LENGTHS) ?: return@forEach

            // 判断微距镜头的核心参数：最小对焦距离≤0.1米，且存在符合范围的焦距
            val hasMacroFocalLength = focalLengths.any { it in 1.0..3.0 }
            if (minFocusDistance <= 0.1 && hasMacroFocalLength) {
                return true
            }
        }
    }
    return false
}

补充说明 #

• 部分厂商可能对微距镜头的参数标定有差异，可根据测试数据微调阈值（比如将最小对焦距离放宽到0.15米）
• 如果需要兼容软件微距场景，可在硬件检测不通过时，额外检查CONTROL_AF_MODE_MACRO是否支持，但需明确标注为“软件微距”

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