人脸预览方向配置方案

日期：2026-07-16
状态：已实施，待设备人工验收

目标

在“设置 → 高级设置 → 摄像头选择”卡片中增加“预览方向”设置。用户选择并点击保存后，应用持久化该角度；后续业务人脸预览和业务人脸识别使用同一个角度值。

当前链路

• 业务预览：CameraPreviewManager.openCamera() 读取 app 模块 BaseConfig.rgbVideoDirection 并调用 Camera.setDisplayOrientation(...)。
• 业务识别：FaceSDKManager.onDetectCheck() 创建 BDFaceImageInstance 时读取 app 模块 BaseConfig.rgbDetectDirection。
• 当前两个 app 配置字段均初始化为 90，app 内没有其他业务写入点。

推荐实现

1. 在高级设置“摄像头选择”下增加 Spinner，选项为 0°、90°、180°、270°，默认值保持为 90°。
2. 在 CameraSettingUtils 增加方向读取、校验、保存和应用：MMKV 记录合法角度；无记录或非法值回退至 90°；应用时同步设置 rgbVideoDirection 和 rgbDetectDirection。
3. 沿用当前“保存”按钮，一次保存摄像头 ID 与方向；保存成功后重启高级设置内预览。
4. 业务预览启动及业务识别取帧前均调用统一应用方法，避免重启或初始化顺序造成不同步。

影响范围与边界

本次配置覆盖 app 业务链路的 gatecamera/CameraPreviewManager（预览显示）与 manager/FaceSDKManager（业务检测/识别输入）。

registerlibrary 另有独立的配置、预览和识别链路，用于 SDK 人员注册/管理页面，并可从独立 JSON 读写方向。它不读取 app 模块配置，因此不在本次默认改动范围；如需统一，必须额外同步并验证注册采集链路。

验收

• 默认显示并使用 90°。
• 保存后重新进入页面仍保持选择。
• 设置页预览与业务识别使用同一角度。
• 0/90/180/270 四个值均可编译并通过设备人工验证。