2026-07-24 设置页人脸 UVC 相机调用与预览变更记录

变更原因

“设置 → 相机设置”原先通过 Camera2/CameraX 获取人脸相机。当前设备虽然在 USB 层连接了 3 个 UVC 相机，但 CameraManager 只稳定暴露其中 1 个，因此设置页无法完整列出设备，预览也可能无法启动。

本次变更

• 设置页的人脸相机列表改为直接枚举 USB 总线上的 UVC 视频设备。
• 下拉项展示产品名和 VID/PID，使用 vendorId_productId 保存设置页 UVC 相机标识。
• 人脸 UVC 选择使用独立配置键，不覆盖现有 Camera2 人脸相机 ID，暂不改变业务识别弹窗和支付流程。
• 人脸预览由 CameraX PreviewView 切换为 UVC TextureView，复用项目已有 UvcCameraController。
• 首次进入时优先选择一个不同于菜品相机的 UVC 设备；选择相同设备时明确提示冲突。
• 打开相机时按设备实际支持列表应用分辨率，避免强制 MJPEG 尺寸导致 invalid preview size。
• 增加相同待打开设备的重复请求防护，并避免初始化回调误触发预览重启。
• 保留旋转、镜像和分辨率设置；仅尺寸变化时重启 UVC 预览。

测试记录

采用测试先行：

1. 新增 UvcCameraIdentityTest，先验证缺少标识实现时编译失败。
2. 实现 UVC 稳定标识后，定向测试通过。

完整验证：

• ./gradlew :app:testDebugUnitTest :app:assembleDebug：成功。
• Debug APK 覆盖安装到 FY-3576SE：成功。
• 真机设置页检测到 3 个 UVC 相机：
  • USB2.0_CAM1 (11391/19040)
  • USB 2.0 Camera (3141/25440)
  • MC-500U (1374/41357)
• 菜品相机保持 1004_1374_41357，人脸预览使用 11391/19040，两路设备未冲突。
• 人脸相机以 640x480 MJPEG 成功打开并持续输出预览画面。
• 页面连续停留 12 秒，SettingActivity 保持前台，未出现 Java 或 UVC 原生崩溃。
• git diff --check：通过。

影响范围

本次仅修改设置页的人脸相机枚举、选择和预览，以及共用 UVC 控制器的尺寸与重复打开保护。业务人脸识别、支付测试和接口协议均未接入本次 UVC 设置，Git 历史未修改。