# 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 | 新增长按五秒规则 |