100 lines
3.4 KiB
Markdown
100 lines
3.4 KiB
Markdown
# App 设备控制规则
|
||
|
||
本文档定义 App 控制 IoT 设备时的通用产品体验。
|
||
|
||
## 适用范围
|
||
|
||
适用于用户可以通过 App 查看状态、发起控制或管理权限的设备。
|
||
|
||
## 规则列表
|
||
|
||
### 控制状态一致
|
||
|
||
规则编号:APP-CONTROL-STATE-CONSISTENCY
|
||
|
||
产品定义:App 展示的设备状态应尽量与用户可感知的设备状态保持一致。
|
||
|
||
用户感知:用户在 App 中看到的开关、状态文案和设备真实表现不应产生明显冲突。
|
||
|
||
触发条件:用户进入设备详情页、发起控制、设备状态变化或收到共享设备状态变化。
|
||
|
||
例外情况:离线、弱网、OTA 升级或设备本地操作导致 App 尚未确认状态时,应展示过渡或不可确认状态。
|
||
|
||
被引用产品:
|
||
|
||
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
|
||
|
||
### 控制反馈
|
||
|
||
规则编号:APP-CONTROL-FEEDBACK
|
||
|
||
产品定义:用户发起控制后,App 应给出明确反馈,避免用户不知道操作是否被接收。
|
||
|
||
用户感知:控制成功时,App 展示新的状态;控制失败时,App 展示失败原因或重试入口;状态未确认时,App 展示处理中。
|
||
|
||
触发条件:用户通过 App 操作开关、亮度、定时、场景或自动化。
|
||
|
||
例外情况:仅本体控制设备不适用。
|
||
|
||
被引用产品:
|
||
|
||
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
|
||
|
||
### 离线控制限制
|
||
|
||
规则编号:APP-CONTROL-OFFLINE-LIMIT
|
||
|
||
产品定义:设备离线时,App 不应让用户误以为远程控制已经立即生效。
|
||
|
||
用户感知:用户可以看到设备离线,控制入口应被限制或明确提示不可用。
|
||
|
||
触发条件:设备处于离线不可控状态时,用户尝试控制设备。
|
||
|
||
例外情况:如果产品支持离线指令排队,应在单品 PDD 中明确说明用户预期和生效条件。
|
||
|
||
被引用产品:
|
||
|
||
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
|
||
|
||
### 多入口控制覆盖
|
||
|
||
规则编号:APP-CONTROL-MULTI-ENTRY-SYNC
|
||
|
||
产品定义:当设备可由 App、本体按键、定时、场景或自动化等多个入口控制时,最新生效的控制结果应成为当前设备状态。
|
||
|
||
用户感知:用户在任一入口操作后,其他入口看到的状态应同步更新。
|
||
|
||
触发条件:多个控制入口先后改变同一设备状态。
|
||
|
||
例外情况:如果某一入口被权限、离线或安全策略限制,应展示对应限制原因。
|
||
|
||
被引用产品:
|
||
|
||
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
|
||
|
||
### 权限不足
|
||
|
||
规则编号:APP-CONTROL-PERMISSION-DENIED
|
||
|
||
产品定义:用户没有控制权限时,App 不应允许其完成控制。
|
||
|
||
用户感知:用户看到权限限制说明,并知道需要联系设备拥有者或切换账号。
|
||
|
||
触发条件:共享用户、访客用户或未授权用户尝试执行受限操作。
|
||
|
||
例外情况:只读共享设备可展示状态,但不得提供有效控制入口。
|
||
|
||
被引用产品:
|
||
|
||
- [智能小夜灯 Mini PDD](../products/smart-lamp-mini/pdd.md)
|
||
|
||
## 版本记录
|
||
|
||
| 日期 | 规则编号 | 变更 |
|
||
| --- | --- | --- |
|
||
| 2026-06-09 | APP-CONTROL-STATE-CONSISTENCY | 新增状态一致规则 |
|
||
| 2026-06-09 | APP-CONTROL-FEEDBACK | 新增控制反馈规则 |
|
||
| 2026-06-09 | APP-CONTROL-OFFLINE-LIMIT | 新增离线控制限制规则 |
|
||
| 2026-06-09 | APP-CONTROL-MULTI-ENTRY-SYNC | 新增多入口控制覆盖规则 |
|
||
| 2026-06-09 | APP-CONTROL-PERMISSION-DENIED | 新增权限不足规则 |
|