倒计时
适用范围:蓝牙项目。 本文的值格式(
start_600000等)只用于蓝牙的文本帧;物联 / WiFi 走 MQTT/JSON,字段形态不同,后续单独成篇。 目前物联 / WiFi 的页面编辑器不提供该组件(组件列表里已隐藏)。
倒计时就是“从设定时间开始,一秒一秒往下减,到 0 结束”。
界面上有什么
- 一个时间显示(剩余多少)
- 启动、暂停、重置 三个按钮
- 可选:结束时执行某个动作(例如发一条通知)
字段:一个倒计时一个名字
| 项 | 说明 |
|---|---|
| 字段名 | 你自己起,例如 shutdown、pump |
| 一个页面多个倒计时 | 每个用不同字段名,例如 pump1、pump2 |
| 单位 | 毫秒(10 分钟 = 600000) |
不要再给倒计时配“时间”“动作”两个字段——一个名字就够了。
和设备的约定
值只有五种:
| 页面/设备发的值 | 意思 |
|---|---|
start_600000 | 开始,剩余 600000 毫秒 |
pause_300000 | 暂停,还剩 300000 毫秒 |
reset_600000 | 设成 600000 毫秒,并停下 |
finished | 我这边已经跑完了 |
finished_ok | 我这边也结束了 |
规则:
start_/pause_必须带毫秒,只写start不会启动reset_只是设时间,不会自动开始- 开始和结束都可以由任意一方发起,另一方回一条即可
- 没有“停止”这个词;要停就用
reset_
一个完整的过程
text
页面:shutdown:start_600000 (开始 10 分钟)
设备:shutdown:start_600000 (我在跑,还剩 600000)
…… 5 分钟后 ……
设备:shutdown:pause_300000 (暂停,还剩 5 分钟)
页面:shutdown:pause_300000 (界面显示已暂停)
…… 用户点击继续 ……
页面:shutdown:start_300000 (从 5 分钟继续)
…… 到 0 ……
设备:shutdown:finished (我跑完了)
页面:shutdown:finished_ok (收到,界面清零并记一条“已完成”)页面重新打开 / 重新连接
设备连上后只发一条:
| 设备当前状态 | 发什么 |
|---|---|
| 正在跑 | start_剩余 |
| 暂停中 | pause_剩余 |
| 停着 | reset_剩余 |
| 已结束 | finished |
页面收到后只刷新界面,不会重新发命令——所以不会出现“页面一打开倒计时就重置”。
常见错误
| 现象 | 原因 |
|---|---|
| 点启动没反应 | 发的是 start,没有带毫秒 |
| 时间差 10 倍 | 一边按秒、一边按毫秒 |
| 暂停后重连变回 0 | 设备重连时发了 reset_,应该发 pause_ |
| 两边都显示完成,设备还在跑 | 收到 finished 后没有立即停 |
| 两个倒计时互相干扰 | 两个组件用了同一个字段名 |
