2026-07-24 人脸相机 UVC 与 Camera2 ID 映射变更记录

变更原因

“设置 → 相机设置”中的人脸相机已经改为 UVC 枚举和预览，保存键为 face_uvc_camera_id；正式人脸支付和支付测试仍通过 CameraX/Camera2 打开相机，读取旧键 face_camera_id。因此设置页选择的物理摄像头没有同步到支付链路。

设备现场确认设置页保存 UVC VID/PID，而支付链路只读取 Camera2 ID，需要在保存时同步两个键。

本次变更

• 新增当前设备三台相机的 UVC VID/PID 与 Camera2 ID 映射：
  • 11391_19040 → 100
  • 3141_25440 → 102
  • 1374_41357 → 128
• 映射同时兼容稳定 UVC ID 和带 USB deviceId 的旧格式。
• 设置页保存 UVC 相机时，由 FaceCameraSettings.setUvcCameraId() 同步保存对应的 face_camera_id。
• 应用启动时执行一次映射同步，自动修正已有安装中的历史错配，无需用户重新进入设置页选择。
• 当尚未保存 UVC 相机时，不清空旧 Camera2 配置，避免升级后影响旧设备。
• 当已保存的非空 UVC 相机没有已知映射时，Camera2 ID 清空，防止支付误开其他摄像头。

测试记录

采用测试先行：

1. 新增三组已知映射、带 deviceId 格式以及未知设备的测试。
2. 首次运行因映射实现不存在而编译失败，确认 RED。
3. 实现映射及双键同步后，定向测试通过。
4. 完整执行 :app:testDebugUnitTest 与 :app:assembleDebug --rerun-tasks，94 个任务全部完成，结果为 BUILD SUCCESSFUL。

设备验证：

• 设置页选择 USB2.0_CAM1 (11391/19040) 后：face_uvc_camera_id = 11391_19040，face_camera_id = 100。
• 设置页切回 USB 2.0 Camera (3141/25440) 后：face_uvc_camera_id = 3141_25440，face_camera_id = 102。
• 物理节点核验：
  • USB2.0_CAM1 位于 /dev/video0，外部 Camera2 ID 为 100。
  • USB 2.0 Camera 位于 /dev/video2，外部 Camera2 ID 为 102。
  • MC-500U 位于 /dev/video28，外部 Camera2 ID 为 128。
• 切换过程中 UVC 预览正常，未出现 Java 或 UVC 原生崩溃。

影响范围

本次仅增加当前固定硬件的 UVC/Camera2 ID 映射，并同步人脸相机配置。正式支付和支付测试继续复用现有 CameraX 人脸帧处理链路；未修改人脸识别算法、菜品识别算法、支付接口、相机冲突拦截或 Git 历史。