设置页双预览占用问题记录

背景

2026-04-04 在“设置 -> 相机设置”中新增了“人脸识别相机设置”模块，目标是：

• 菜品识别相机设置继续保留现有 USB 预览与识别区域编辑
• 人脸识别相机设置按相同风格补充：
  • 摄像头选择
  • 分辨率
  • 旋转
  • 镜像
  • 预览画面
• 人脸识别设置不包含预览区域编辑

项目内两套相机链路本身并不相同：

• 菜品识别设置页预览走 CameraUsbUtils
• 人脸识别预览与识别走 CameraPreviewManager + SingleBaseConfig

已知现场使用时，菜品识别相机和人脸识别相机不是同一个物理设备。

问题现象

在第一版实现中，进入“设置 -> 相机设置”页面后，会出现：

• 菜品识别相机提示“设备被占用”
• 页面初始化阶段容易出现相机资源冲突

但在用户确认现场设备后可以排除一个常见误判：

• 不是“菜品识别相机”和“人脸识别相机”被配置成了同一台物理相机

初步排查结论

问题的核心不在“两个设置项选中了同一设备”，而在“设置页初始化时，同时拉起了两套预览链路”：

• 菜品识别区域进入页面时，会自动启动 CameraUsbUtils 预览
• 人脸识别区域第一版也被实现成进入页面自动准备预览

另外，人脸识别区域第一版为了动态读取可选分辨率，初始化时会尝试直接 Camera.open(cameraId) 获取支持尺寸列表。
这一步虽然只是为了填充分辨率下拉框，但在设置页打开阶段就提前触发了系统相机占用。

也就是说，第一版的冲突来源更接近下面两点：

1. 页面一进入就自动拉起两套相机管理器
2. 人脸设置初始化分辨率时还会额外主动打开一次系统相机

验证过程

为确认问题来源，曾临时把人脸预览改成“手动开启”：

• 进入设置页时不再自动启动人脸预览
• 只有用户点击“开启预览”才走 CameraPreviewManager.startPreview(...)
• 同时去掉“初始化分辨率时直接 Camera.open(...) 探测支持尺寸”的做法

验证结果：

• 进入“设置 -> 相机设置”时，不再出现菜品识别相机被占用

这说明问题并不是“页面里放了两块预览 UI 就一定冲突”，而是“初始化阶段对人脸相机资源的抢占方式”有问题。

最终处理

在确认“手动开启时不再占用”后，最终实现调整为：

1. 保留人脸识别预览画面

设置页仍然支持同时看到：

• 菜品识别预览
• 人脸识别预览

也就是最终仍然支持“自动双预览”。

2. 不再在分辨率初始化时主动 Camera.open(...)

人脸识别分辨率下拉改为非侵入式方案：

• 优先展示已保存值
• 补充常用分辨率选项
  • 640x480
  • 1280x720
  • 1920x1080

这样可以避免“只是为了显示分辨率下拉框，却在页面初始化时抢先占用系统相机”。

3. 自动预览只保留真正需要的启动逻辑

最终恢复为：

• 进入设置页时自动显示人脸预览

但不再恢复第一版里那种“为了探测参数而额外打开相机”的初始化方式。

结论

本次问题的真正原因可以归纳为：

• 相机占用并不是因为菜品识别相机和人脸识别相机配置成了同一个物理设备
• 而是因为人脸识别设置模块在页面初始化阶段，存在额外的系统相机打开动作
• 该动作和菜品识别设置页已有的预览初始化叠加后，触发了设备占用冲突

最终结论：

• “自动双预览”本身可以保留
• 关键是不要在设置页初始化阶段做多余的相机探测与抢占

当前结果

当前设置页行为为：

• 菜品识别区域自动预览
• 人脸识别区域自动预览
• 不再因进入“设置 -> 相机设置”而触发菜品识别相机被占用

验证

已执行：

./gradlew :app:compileDebugJavaWithJavac

结果：BUILD SUCCESSFUL