Camera2 API问题：Poco X3 Pro无法获取广角镜头物理相机ID

问题原因 #

• 厂商Camera2 API定制导致物理相机未暴露
  Poco X3 Pro作为小米系设备，部分厂商会对原生Camera2 API做定制修改。即使硬件配备了广角镜头，系统可能没有通过Camera2的标准接口（physicalCameraIds）对外暴露物理相机ID，而是仅支持自家MIUI相机SDK或通过变焦逻辑间接切换镜头。

• Camera2硬件支持等级限制
  通过INFO_SUPPORTED_HARDWARE_LEVEL可查看设备的Camera2兼容等级：如果是LEGACY或LIMITED等级，说明设备仅支持Camera2基础功能，多物理相机这类高级特性无法通过标准接口调用。

• 变焦切换逻辑不匹配设备实现
  0.6倍是广角镜头的典型焦段，但如果设备未通过物理相机ID暴露镜头，直接设置变焦比例可能无法触发硬件切换——部分厂商要求特定的参数配置，或仅支持通过私有接口切换镜头。

解决建议 #

• 验证变焦范围并尝试标准变焦切换
  先获取相机支持的变焦范围，确认0.6倍是否在支持范围内，再通过CaptureRequest.CONTROL_ZOOM_RATIO设置变焦值，同时监听CaptureResult参数确认镜头是否切换：

  // 在createCameraPreviewSession中添加变焦设置
  val captureRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW)
  captureRequestBuilder.set(CaptureRequest.CONTROL_ZOOM_RATIO, 0.6f)
  

• 切换到CameraX简化适配
  CameraX是Jetpack相机组件，对设备兼容性做了统一封装，即使厂商Camera2实现不标准，CameraX也能通过适配层调用到硬件镜头，无需手动处理物理相机ID的问题。

• 补充调试信息定位问题
  在现有代码中添加硬件等级和变焦范围的日志，进一步确认设备的Camera2支持能力（代码修改如下）：

private fun openCamera() {
        try {
            val cameraId = cameraManager.cameraIdList[0] ?: return
            val characteristics = cameraManager.getCameraCharacteristics(cameraId)
            
            // 打印Camera2硬件支持等级
            val hardwareLevel = characteristics.get(CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL)
            Log.d(TAG, "Camera Hardware Level: $hardwareLevel")
            
            // 打印支持的变焦范围
            val zoomRange = characteristics.get(CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE)
            Log.d(TAG, "Supported Zoom Range: ${zoomRange?.lower} ~ ${zoomRange?.upper}")
            
            val capabilities = characteristics.physicalCameraIds
            Log.d(TAG, "Physical Camera IDs: $capabilities")
            previewSize = characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP)!!
                .getOutputSizes(SurfaceTexture::class.java)[0]
            if (ActivityCompat.checkSelfPermission(
                    this,
                    Manifest.permission.CAMERA
                ) != PackageManager.PERMISSION_GRANTED
            ) {
                return
            }
            cameraManager.openCamera(cameraId, object : CameraDevice.StateCallback() {
                override fun onOpened(camera: CameraDevice) {
                    cameraDevice = camera
                    createCameraPreviewSession()
                }

                override fun onDisconnected(camera: CameraDevice) {
                    camera.close()
                }

                override fun onError(camera: CameraDevice, error: Int) {
                    camera.close()
                }
            }, null)
        } catch (e: CameraAccessException) {
            e.printStackTrace()
        }
    }

内容的提问来源于stack exchange，提问作者Angelo Pavani Neto