拍报机需求分析

Design an Ad module for Android that supports:
- looping video playback
- looping image slideshow
- floating start button
- fast resource release when exiting

Design a camera preview and single-shot capture module
for an embedded Android device.
Requirements:
- 3-second countdown
- no UI dependency
- stable long-running behavior

Design a photo template system that supports:
- background switching
- preview rendering
- final print rendering

Design a QR-based photo upload flow
that supports async upload, timeout, and retry.

Design a WeChat QR payment flow suitable for a kiosk device.
Focus on reliability and state recovery.

Design a printing flow with QR code download support.
Printing must be transactional and recoverable.

+---------------------------+
|   用户确认打印/下载二维码  |
+-----------+---------------+
            |
            v
+---------------------------+
| 渲染高分打印图（照片+模板） |
+-----------+---------------+
            |
            v
+---------------------------+
|   生成 PCL/PostScript 数据  |
+-----------+---------------+
            |
            v
+---------------------------+
|  建立 TCP Socket 连接打印机 |
|      (Port 9100)          |
+-----------+---------------+
            |
            v
+---------------------------+
|  异步发送 PCL 数据流       |
|  (分包 / 缓冲处理)        |
+-----------+---------------+
            |
            v
+---------------------------+
| 等待打印机 ACK 或状态响应  |
+-----------+---------------+
            |
      +-----+-----+
      |           |
      v           v
+-----------+   +----------------+
| 打印完成  |   | 打印失败/重试 |
+-----------+   +----------------+
      |                 |
      v                 v
+-----------+   +----------------+
| 状态机更新 |   | 异常处理/回退 |
| DONE/打印完成 |  | 返回广告页或重试 |
+-----------+   +----------------+

目标： 建立全局唯一状态源，确保无人值守逻辑不乱。

给 Claude Code 的指令：

我们要基于 RK3568 (4+32G) 开发拍报机。请先构建项目基础骨架：

使用 MVI (Model-View-Intent) 架构。定义 MachineState 密封类，涵盖：IdleAd（广告）、CameraCapture（拍照）、PhotoEdit（合成预览）、Payment（支付）、Printing（打印中）、Finish（完成）。

创建一个全局 AppStateManager，使用 StateFlow 驱动 UI 切换。

配置 build.gradle，引入 CameraX、ExoPlayer、MQTT-Paho、Glide 和 Zxing 依赖。

针对 1080x1920 竖屏，生成基础布局资源文件

目标： 解决风险最高的两个环节。

给 Claude Code 的指令： “现在处理核心硬件对接，请分步完成：

相机： 实现 CameraModule。针对 1080P 预览，确保不拉伸，并提供一个 takePhoto() 方法，拍照后返回 Bitmap。

打印： 编写 HPPrintService。使用 IPP 协议 封装，通过 TCP 631 端口向指定 IP 的 HP 5255 发送打印任务。

状态反馈： 打印类必须能异步返回：CONNECTING, PRINTING, SUCCESS, ERROR_PAPER_OUT（缺纸）。

由于有 4G 内存，拍照和预览时不需要强制销毁视频插件，保持切换流畅。”

目标： 实现远程控制和手机扫码交互。

给 Claude Code 的指令： “现在实现通讯模块：

MQTT： 编写一个长连接服务。监听 ad/update（更新素材）和 cmd/reboot 指令。

异步通知： 当用户在‘手机上传界面’扫描二维码后，服务器会发送 MQTT 消息告知 App 上传成功。请写好监听逻辑，收到信号后自动跳转到 PhotoEdit 状态。

资源下载： 编写一个 DownloadManager，支持断点续传下载服务器下发的视频素材到 32G 存储空间。”

目标： 利用 4G 内存优势，实现高质量合成。

给 Claude Code 的指令： “请实现图片合成逻辑：

用户拍照后，需要将照片叠加在服务器下载的 PNG 模板之上。

使用 Canvas 进行离屏渲染。因为内存充足，请使用 Config.ARGB_8888 保证最高画质，并支持双指缩放和位移微调照片。

生成一个用于打印的 300 DPI 高清图和用于显示的低分缩略图。”

目标： 确保机器死不了。

给 Claude Code 的指令： “最后，增加鲁棒性逻辑：

无操作超时： 在非广告状态下，若 60 秒无交互，自动回退到 IdleAd 状态。

异常保护： 如果打印机断开或 MQTT 掉线，在屏幕右上角显示一个微小的 UI 提示，但不阻碍用户基本浏览。

定时任务： 每天凌晨 3 点，检查是否有新广告素材，并清理 7 天前的缓存图片。”