FaceStudyPop 拍照方向与镜像修复方案及实施记录

结论：实时预览通过 View 层旋转为正向，但 TextureView.getBitmap() 返回的原始纹理不包含旋转和镜像，导致右侧照片、保存文件和上传头像横倒。本次在生成 mCurrentBitmap 时补齐预览实际变换。

问题现象

左侧实时预览经过方向校正后可以正常显示；点击“拍照”后，右侧照片横倒 90 度，并因横图放入竖向 centerCrop 容器而发生二次裁切。保存和上传文件也保持错误方向。

根因证据

• 现场设备 YF_029E 的 Camera 0 实际预览帧为 640x480，方向为 90 度。
• CameraPreviewManager 使用 TextureView.setRotation(90) 校正实时预览。
• FaceStudyPop 原来直接读取 TextureView Bitmap，该结果不包含 View 旋转和父容器镜像。
• 现场错误文件为 320x240；正确校正后应为 240x320。

修复边界

• 只修改 FaceStudyPop.java。
• 不修改相机预览、人脸检测方向、识别阈值和弹框布局。
• 保留异步保存、上传接口和列表刷新链路。

实施方案

1. 新增 captureDisplayedBitmap() 获取 TextureView 原始 Bitmap。
2. 读取控件实际生效的 getRotation()，兼容 Camera1、K203 Camera2 和高级设置方向。
3. 读取父预览容器的 getRotationY()，在 180 度时执行水平镜像。
4. 通过 Matrix 按“旋转后镜像”生成最终 Bitmap，与现有 FaceSDK 变换顺序保持一致。
5. 右侧显示、PNG 保存和上传共用校正后的 mCurrentBitmap。
6. 连续重拍时回收上一张已不再使用的 Bitmap。

预期结果

为什么不只旋转 ImageView

只旋转 ImageView 只能修正界面显示，保存和上传文件仍然横倒。本方案在数据源 mCurrentBitmap 上修正，确保显示、保存和上传一致。

验证记录

• 目标文件执行 git diff --check，无空白错误。
• JDK 8 执行单元测试与 Debug 构建，结果为 BUILD SUCCESSFUL in 1m 6s。
• Debug APK SHA-256：53cf14f8aecbb2a241a8a89e12389ca96e1c970a57bb3745cdca4ec0dfead706。
• 对截图对应的 YF_029E 覆盖安装，adb install -r 返回 Success。
• 实机重新拍照后，保存文件由 320x240 变为 240x320，人物方向正常。
• 未点击“上传”，服务端人员头像未变更。

非目标与风险

• 不调整相机物理取景角度和人员站位。
• K203 的 16:9 Camera2 画面继续沿用现有 center-crop 策略。
• 当前设备镜像配置为关闭，已验证 90 度方向；镜像开启及其他方向仍需补充回归。