# 通用配网体验规则

本文档定义 App 管理型 IoT 设备的通用配网体验。

## 适用范围

适用于需要用户通过 App 添加、联网或绑定的设备。

## 规则列表

### 进入配网

规则编号：NET-PAIRING-ENTER

产品定义：设备进入等待 App 添加的状态。

用户感知：设备本体应给出配网提示，App 应引导用户完成添加。

触发条件：新设备首次上电、用户长按重置按键，或用户在 App 中重新添加设备。

例外情况：设备无状态灯时，应在单品 PDD 中定义替代体验。

被引用产品：

- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)

### 配网成功

规则编号：NET-PAIRING-SUCCESS

产品定义：设备完成添加、绑定并进入可管理状态。

用户感知：App 展示添加成功，并进入设备控制页或设备列表。

触发条件：设备完成用户授权下的绑定流程。

例外情况：如果设备添加成功但暂时不可控，App 应明确展示对应状态。

被引用产品：

- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)

### 配网失败

规则编号：NET-PAIRING-FAILED

产品定义：设备未能完成添加、联网或绑定。

用户感知：App 展示失败原因和重试入口，设备本体给出失败提示。

触发条件：用户取消、设备未被发现、网络不可用、授权失败或设备状态不满足添加条件。

例外情况：失败原因无法判断时，App 使用通用失败提示。

被引用产品：

- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)

### 配网超时

规则编号：NET-PAIRING-TIMEOUT

产品定义：设备进入配网流程后，如果在规定时间内未完成绑定，系统应判定为配网超时。

用户感知：App 展示配网失败，并提供重新配网入口。

触发条件：用户发起配网后，设备未在规定时间内完成绑定。

例外情况：具备屏幕的设备可以在屏幕端同步展示超时提示。

被引用产品：

- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)

## 版本记录

| 日期 | 规则编号 | 变更 |
| --- | --- | --- |
| 2026-06-09 | NET-PAIRING-ENTER | 新增进入配网规则 |
| 2026-06-09 | NET-PAIRING-SUCCESS | 新增配网成功规则 |
| 2026-06-09 | NET-PAIRING-FAILED | 新增配网失败规则 |
| 2026-06-09 | NET-PAIRING-TIMEOUT | 新增配网超时规则 |