Files
pdd-word/docs/domain/hmi-dictionary.md
2026-06-09 23:04:53 +08:00

129 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# HMI 全局交互字典
本文档定义无屏 IoT 设备常用的指示灯、按键和本体反馈语言。
## 适用范围
适用于具备本体按键、指示灯或简单反馈能力的无屏设备。
## 规则列表
### 白灯常亮
规则编号HMI-LIGHT-WHITE-ON
适用范围:具备白色照明能力的灯类设备。
产品定义:主灯处于开启状态。
用户感知:用户可以直接看到设备发光。
触发条件:用户通过 App、本体按键、自动化、定时或其他被授权入口打开设备。
例外情况:设备进入故障保护、断电、离线不可控或 OTA 升级限制状态时,主灯表现以对应规则为准。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
### 白灯熄灭
规则编号HMI-LIGHT-WHITE-OFF
适用范围:具备白色照明能力的灯类设备。
产品定义:主灯处于关闭状态。
用户感知:用户可以直接看到设备不发光。
触发条件:用户通过 App、本体按键、自动化、定时或其他被授权入口关闭设备。
例外情况设备断电时不等同于用户主动关闭App 应根据设备状态区分展示。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
### 蓝灯慢闪
规则编号HMI-LIGHT-BLUE-SLOW
适用范围:具备蓝色状态指示灯的无屏设备。
产品定义:设备正在等待配网或绑定。
用户感知:用户可通过 App 搜索并绑定设备。
触发条件:设备进入配网状态。
例外情况:不具备独立状态指示灯的设备,应在单品 PDD 中定义替代体验。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
### 蓝灯急闪三次
规则编号HMI-LIGHT-BLUE-FAST-3
适用范围:具备蓝色状态指示灯的无屏设备。
产品定义:设备配网或绑定失败。
用户感知:用户可感知当前操作未成功,需要回到 App 查看失败原因并重试。
触发条件:配网失败、绑定失败或用户主动取消配网。
例外情况:失败原因需要由 App 展示,不应仅依赖指示灯表达。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
### 按键短按
规则编号HMI-BUTTON-SHORT-PRESS
适用范围:具备单个本体按键的设备。
产品定义:用户进行一次短时按压,用于触发设备最常用的即时操作。
用户感知:设备应在短按后立即给出可见或可感知反馈。
触发条件:用户短按设备按键。
例外情况设备处于配网、OTA、故障保护等限制状态时应在单品 PDD 中说明短按是否可用。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
### 长按五秒
规则编号HMI-BUTTON-LONG-PRESS-5S
适用范围:具备本体按键且支持重置的设备。
产品定义:用户长按按键 5 秒,用于触发设备重置或进入配网准备状态。
用户感知:设备进入可重新绑定或重新配网的状态。
触发条件:用户连续按住设备按键达到 5 秒。
例外情况:是否清除已有绑定关系,由对应产品的绑定规则或单品 PDD 定义。
被引用产品:
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
## 版本记录
| 日期 | 规则编号 | 变更 |
| --- | --- | --- |
| 2026-06-09 | HMI-LIGHT-WHITE-ON | 新增灯类设备主灯开启规则 |
| 2026-06-09 | HMI-LIGHT-WHITE-OFF | 新增灯类设备主灯关闭规则 |
| 2026-06-09 | HMI-LIGHT-BLUE-SLOW | 新增配网等待状态规则 |
| 2026-06-09 | HMI-LIGHT-BLUE-FAST-3 | 新增配网失败反馈规则 |
| 2026-06-09 | HMI-BUTTON-SHORT-PRESS | 新增短按规则 |
| 2026-06-09 | HMI-BUTTON-LONG-PRESS-5S | 新增长按五秒规则 |