实况任务 · LiveTask

HarmonyOS 实况窗（Live View Kit）自定义任务计时应用：创建你的任务，离开应用，实况窗替你盯着。

功能特性

• 自定义任务上岛：设置任务名称、内容、保留时长，开始任务后实况窗常驻灵动岛 / 状态栏并自动倒计时，返回应用自动收起，到期自动结束
• 实况窗小图标：内置 11 个简约白色线条图标，也可从相册选择照片（封面、票据、宠物都行）
• 本地持久化：任务与运行状态全部落盘，清后台 / 进程被杀 / 重启后自动恢复并重新接管实况窗
• 沉浸光感 UI：清华紫 + 淡蓝配色、光斑背景 + 毛玻璃卡片、沉浸式全屏、深浅色自适应
• 正计时 / 倒计时：正计时模式手动结束，倒计时模式到点自动收起
• 截图识别取件码：从快递截图离线 OCR 识别取件码 / 取餐号，自动填充任务（真机可用，模拟器多数无 OCR 服务）

技术要点

• Live View Kit（liveViewManager）：本地创建 / 更新 / 结束实况窗，TimerCapsule 系统级倒计时，ProgressLayout 进度卡片
• 可靠持久化：@ohos.data.preferences 同步写入 + 串行 flush()，解决 PersistentStorage 刷盘延迟导致的丢数据问题
• 确定性实况窗 ID：持久化自增 viewSeq，进程重启后通过 getActiveLiveView 接管残留实况窗
• 离线 OCR：Core Vision Kit textRecognition，图片不出设备；正则提取取件码
• 沉浸式全屏：setWindowLayoutFullScreen + 避让区动态适配，光斑背景延伸至状态栏 / 手势条后
• 机型无关背景：光斑尺寸 / 圆心 / 半径全部使用百分比，任意分辨率等比缩放

工程结构

entry/src/main/ets/
├── entryability/EntryAbility.ets   # 入口：沉浸式窗口、持久化初始化
├── liveview/LiveController.ets     # 实况窗控制器（单例）：发布/接管/倒计时/收起
├── common/TaskModel.ets            # 任务模型与内置图标
├── common/TaskStore.ets            # 可靠持久化
├── pages/Index.ets                 # 首页：任务列表 / 进行中状态卡
├── pages/TaskEditor.ets            # 任务编辑：字段 / 图标选择 / 时长 / OCR
└── views/PageBackdrop.ets          # 沉浸光感背景
tools/                              # 图标生成、AGC 申请附件制作脚本

构建与运行

1. DevEco Studio 6.0+ 打开本目录
2. 签名信息不入库（仓库内 signingConfigs 保持为空）：在 File → Project Structure → Signing Configs 勾选自动签名（需登录华为账号）
3. 连接模拟器或真机，Run 即可

命令行工具（Git Bash）：./build.sh 构建 debug HAP；./phone.sh 部署 / 日志 / 截屏工具箱（用法见脚本头注释）。

实况窗在真机上需要实况窗服务权益（AGC 开放能力管理申请，计时场景）；模拟器无需权益即可调试。权益申请、API 实测结论与自动化测试坑见 LIVETASK-NOTES.md。

License

MIT