红外感应控制弹框设计

日期：2026-07-31

目标

将“设置 → 高级设置”中原有的“去掉辅助餐盘识别”单一操作改为统一的“红外感应设置”入口。用户在弹框内执行打开或关闭红外感应，并查看最近一次打开和最近一次关闭的操作时间。

交互设计

高级设置中只保留一个入口：

红外感应设置

点击后打开操作弹框，展示：

红外感应设置

最近打开：2026-07-31 14:20:35
最近关闭：2026-07-30 09:12:08

[打开红外感应]  [关闭红外感应]

没有相应记录时显示：

最近打开：暂无记录
最近关闭：暂无记录

弹框不展示“当前状态”或“最近判断”，只客观展示本应用最近成功发送打开、关闭命令的时间。

视觉规格

• 弹框宽度为 760dp，延续项目现有蓝色标题栏和白色内容区样式。
• 内容区左右内边距为 56dp，给两个操作按钮留出足够宽度。
• “打开红外感应”“关闭红外感应”按钮等宽铺满操作区，高度为 60dp，间距为 28dp。
• 底部“取消”使用项目现有描边取消按钮背景，宽度为 320dp、高度为 60dp，蓝色粗体文字并水平居中。

操作规则

打开红外感应

1. 用户点击“打开红外感应”。
2. 弹出“确认打开红外感应？”二次确认。
3. 确认后发送恢复命令：3E 53 43 41 4E 30 36 30 31 30 30 35 81 3C。
4. 串口完成写入和刷新后，保存最近打开时间并刷新弹框。
5. 串口发送失败时不更新时间，显示失败原因并记录失败日志。

关闭红外感应

1. 用户点击“关闭红外感应”。
2. 弹出“确认关闭红外感应？”二次确认。
3. 确认后发送去掉命令：3E 53 43 41 4E 30 36 30 30 30 30 35 80 3C。
4. 串口完成写入和刷新后，保存最近关闭时间并刷新弹框。
5. 串口发送失败时不更新时间，显示失败原因并记录失败日志。

数据设计

使用现有 MmkvUtils 保存两个独立的毫秒时间戳：

展示时将大于 0 的时间戳格式化为 yyyy-MM-dd HH:mm:ss；值为 0 时显示“暂无记录”。

每次操作同时写入现有本地日志，记录操作类型、发送结果和操作时间。失败操作只进入日志，不覆盖最近成功操作时间。

实现范围

• activity_set.xml：把原有单一操作入口调整为“红外感应设置”。
• strings.xml：增加入口、弹框、按钮、确认及时间展示文案。
• SetActivity.java：打开配置弹框并接收打开、关闭操作结果。
• 新增红外感应设置弹框组件及对应布局。
• AuxiliaryTrayRecognitionController.java：保留关闭命令并增加打开命令。
• Constants.java：增加最近打开、最近关闭时间配置键。
• MmkvUtils：补充 Long 类型读写支持，用于保存毫秒时间戳。
• YoukateHardwareManager.java：继续复用现有 sendCommand()，不改变串口初始化和生命周期。

并发与异常处理

• 任一配置命令发送期间，打开和关闭按钮均不可再次触发。
• 用户取消二次确认时不发送命令、不更新时间。
• 串口未初始化、输出流不可用或写入异常时，保留现有错误提示。
• Activity 销毁时关闭操作弹框和二次确认框，不再更新已销毁的界面或执行旧确认回调。
• 本地时间仅代表本应用成功完成串口写入的时间，不代表设备返回了执行确认。
• 应用数据被清除、应用重新安装或设备由其他工具配置后，本地记录可能与设备实际情况不同，因此不据此推断当前状态。

验收标准

1. 高级设置只显示一个“红外感应设置”入口。
2. 弹框能正确显示最近打开、最近关闭时间，无记录时显示“暂无记录”。
3. 打开操作发送 3E5343414E30363031303035813C。
4. 关闭操作发送 3E5343414E30363030303035803C。
5. 只有串口发送成功才更新对应时间；发送失败不更新时间。
6. 打开、关闭操作都写入本地日志，失败日志包含失败原因。
7. 连续点击和交叉点击不会重复发送配置命令。
8. 使用项目要求的 JDK 8 完成 Debug 构建。
9. 在目标设备验证关闭后红外不再感应、打开后红外恢复感应。

结论

采用一个弹框集中提供打开、关闭操作，并分别保存最近一次成功发送打开和关闭命令的时间。界面不推断设备当前状态，以避免本地记录被误认为硬件真实状态。

实施状态

已于2026-07-31按本设计完成代码实现：

• 高级设置已统一为一个“红外感应设置”入口。
• 弹框提供打开、关闭操作，并展示两个最近成功操作时间。
• 弹框已按项目现有弹框风格加宽，并统一放大操作按钮和底部取消按钮。
• 打开、关闭均需二次确认，发送期间统一禁止重复操作。
• 只有串口写入成功才更新对应时间，失败只记录日志。
• 已增加两条命令和时间格式单元测试。
• JDK 8 本地单元测试和 Debug 构建通过。

串口实际字节和红外模块生效情况仍需在目标设备完成实机验收。