New Dish Learning Integration

本次改动

• 新增 NewDishLearningActivity，页面结构沿用原 DishLearningActivity，学习逻辑改为真实调用银歌 SDK。
• DishRecognitionActivity 和 DishManagementActivity 的菜品学习入口已切换到 NewDishLearningActivity。
• DishManagementActivity 已改为读取真实菜品列表 + 本地真实学习图片，不再使用 mock 数据。

SDK 接口使用

• 初始化 SDK：initAiService
• 实时识别取框：aiAutoRecognition
• 保存学习图后写入学习特征：aiLearnWithCodeAndImage
• 删除单张学习图对应特征：removeLearnFeatureWithImage
• 按学习目录做数据校正：learnDateRivise

SDK 初始化封装

修改原因

• 之前 DishLearningActivity、NewDishLearningActivity、DishManagementActivity 都各自执行一遍 YingeoAiSDK.getInstance() + initAiService(...)。
• 每个页面都维护一套 IYingeoAIServiceCallback 初始化入口，重复代码较多，插件安装成功后的重新初始化逻辑也分散在各个页面里。
• 页面销毁时各自 unInitAiService()，在多页面切换场景下容易出现 SDK 被反复释放和重建，不利于后续统一维护。

当前方案

• 新增统一入口：app/src/main/java/com/cpt/aidishrecognition/ai/AiSdkManager.java
• AiSdkManager 负责：
  • 持有全局唯一的 YingeoAiSDK 实例
  • 统一执行 initAiService(...)
  • 统一接收 SDK 原始回调，再分发给各页面注册的 Observer
  • 在 AI 插件安装成功后自动重新初始化 SDK
• 页面不再直接持有自己的 IYingeoAIServiceCallback 初始化入口，而是改为注册 AiSdkManager.Observer

改完后的使用方式

1. 页面进入时先调用：
   • mYingeoAiSDK = AiSdkManager.getInstance().ensureInitialized(this);
2. 再注册页面自己的观察者：
   • AiSdkManager.getInstance().registerObserver(aiServiceObserver);
3. 页面里只保留业务相关回调处理：
   • onInitSuccess
   • onMessage
   • onAiRecognitionResult
   • onAiModelProgress
   • 其他按需实现
4. 页面销毁时注销观察者：
   • AiSdkManager.getInstance().unregisterObserver(aiServiceObserver);
5. 普通业务页面不再主动调用 unInitAiService()，避免切页时把共享 SDK 服务反复销毁

已切换到统一初始化的页面

• DishLearningActivity
• NewDishLearningActivity
• DishManagementActivity

说明：

• 现在 initAiSDK() 仍然保留在页面里，但职责已经变成“通过 AiSdkManager 获取已初始化的 SDK 引用”，不再直接执行页面级的 initAiService(...)。
• 如果后续新增需要使用银歌 SDK 的页面，优先复用 AiSdkManager，不要再复制一套新的 IYingeoAIServiceCallback 初始化代码。

菜品编码映射

• 优先使用接口返回的 dishUuid 作为 SDK 学习编码。
• 如果 dishUuid 为空，则回退为 dishId 字符串。

说明：

• 这个编码同时用于 SDK 学习、学习图片目录名、管理页删除图片。
• 如果后端后续明确要求使用别的业务主键，需要统一替换 DishLearningStore.resolveDishCode()。

本地学习数据目录

• 目录：/sdcard/YingeoAiSDK/aiImages/<dishCode>/
• 文件命名：序号_时间戳十六进制.jpg

当前学习流程

1. 在 NewDishLearningActivity 选择菜品
2. 点击“拍照学习”
3. 使用当前预览帧调用 aiAutoRecognition 获取识别框
4. 按识别框裁图，先显示在右侧学习记录中
5. 点击“保存”后：
   • 图片写入 SDK 学习目录
   • 调用 aiLearnWithCodeAndImage(dishCode, imagePath) 完成真实学习
   • 刷新右侧和管理页真实学习记录

识别区域与红框显示

保存方式

• 相机设置页保存的是四个顶点的绝对坐标：
  • leftTopPointX/Y
  • rightTopPointX/Y
  • rightBottomPointX/Y
  • leftBottomPointX/Y
• 同时保存设置页当时 CropView 的宽高：
  • cropViewWith
  • cropViewHeight

说明：

• 这套保存方式与 yingeoai-sdk-restaurant-demo 一致，不是保存百分比，而是保存“绝对点位 + 当时视图尺寸”。

为什么不同页面会看起来不一样

• CropView 画的是当前页面自身 View 坐标，不是相机原始分辨率坐标。
• 如果设置页、学习页、识别页的预览区域尺寸不同，直接复用原始点位就会出现红框位置和大小不一致的问题。
• 另外，相机旋转、镜像、预览拉伸方式不同，也会进一步放大视觉偏差。

当前处理方案

• 新增统一缩放工具：app/src/main/java/com/cpt/aidishrecognition/ai/CropRegionHelper.java
• 处理方式：
  1. 读取设置页保存的四个角点
  2. 读取保存时的 cropViewWith/cropViewHeight
  3. 根据当前页面 CropView 的实际宽高计算缩放比例
  4. 将保存点位缩放后再显示到当前页面

当前已接入红框显示的页面

• 相机设置页：可编辑红框，负责保存识别区域
• NewDishLearningActivity：只读红框展示
• DishRecognitionActivity：只读红框展示

说明：

• 学习页和识别页中的 CropView 已设为只读模式，仅用于显示设置页保存的识别区域，不允许在业务页面拖动修改。
• 如果后续还有新的相机预览页面需要显示识别区域，优先复用 CropRegionHelper.applySavedRegion(...)，不要再直接把原始点位写死到页面里。

与识别裁剪参数的关系

• PredictImageClipper.checkPredictCropParam() 会把这组坐标和 cropViewWith/cropViewHeight 组装成 SDK 所需的 CropSize
• NewDishLearningActivity 已改为按 demo 方式使用该 CropSize
• 这意味着：
  • 设置页负责定义识别区域
  • 识别页 / 学习页负责按当前页面缩放显示红框
  • SDK 识别时继续使用保存的原始区域参数

排查建议

• 如果学习页或识别页红框位置不对，先检查设置页保存的区域是否正确。
• 如果红框位置基本正确，但和预览内容仍有轻微错位，优先排查：
  • 相机旋转 cameraRotation
  • 镜像开关 KEY_CAMARA_MIRROR
  • 当前预览控件与设置页预览控件的宽高比差异
• 如果后续发现是“预览内容实际显示区域”与整个 TextureView 存在留白差异，需要再额外补一层可视区域偏移换算。

已知约束

• 当前新学习页的预览链路采用项目内现有 CameraUsbUtils，适配 USB 相机工作流。
• 管理页“数据同步”按钮现在对应 SDK 的 learnDateRivise，用于按本地学习目录重新校正学习数据。