Files
pdd-word/docs/domain/app-device-control.md
2026-06-09 23:04:53 +08:00

3.4 KiB
Raw Permalink Blame History

App 设备控制规则

本文档定义 App 控制 IoT 设备时的通用产品体验。

适用范围

适用于用户可以通过 App 查看状态、发起控制或管理权限的设备。

规则列表

控制状态一致

规则编号APP-CONTROL-STATE-CONSISTENCY

产品定义App 展示的设备状态应尽量与用户可感知的设备状态保持一致。

用户感知:用户在 App 中看到的开关、状态文案和设备真实表现不应产生明显冲突。

触发条件:用户进入设备详情页、发起控制、设备状态变化或收到共享设备状态变化。

例外情况离线、弱网、OTA 升级或设备本地操作导致 App 尚未确认状态时,应展示过渡或不可确认状态。

被引用产品:

控制反馈

规则编号APP-CONTROL-FEEDBACK

产品定义用户发起控制后App 应给出明确反馈,避免用户不知道操作是否被接收。

用户感知控制成功时App 展示新的状态控制失败时App 展示失败原因或重试入口状态未确认时App 展示处理中。

触发条件:用户通过 App 操作开关、亮度、定时、场景或自动化。

例外情况:仅本体控制设备不适用。

被引用产品:

离线控制限制

规则编号APP-CONTROL-OFFLINE-LIMIT

产品定义设备离线时App 不应让用户误以为远程控制已经立即生效。

用户感知:用户可以看到设备离线,控制入口应被限制或明确提示不可用。

触发条件:设备处于离线不可控状态时,用户尝试控制设备。

例外情况:如果产品支持离线指令排队,应在单品 PDD 中明确说明用户预期和生效条件。

被引用产品:

多入口控制覆盖

规则编号APP-CONTROL-MULTI-ENTRY-SYNC

产品定义:当设备可由 App、本体按键、定时、场景或自动化等多个入口控制时最新生效的控制结果应成为当前设备状态。

用户感知:用户在任一入口操作后,其他入口看到的状态应同步更新。

触发条件:多个控制入口先后改变同一设备状态。

例外情况:如果某一入口被权限、离线或安全策略限制,应展示对应限制原因。

被引用产品:

权限不足

规则编号APP-CONTROL-PERMISSION-DENIED

产品定义用户没有控制权限时App 不应允许其完成控制。

用户感知:用户看到权限限制说明,并知道需要联系设备拥有者或切换账号。

触发条件:共享用户、访客用户或未授权用户尝试执行受限操作。

例外情况:只读共享设备可展示状态,但不得提供有效控制入口。

被引用产品:

版本记录

日期 规则编号 变更
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 新增权限不足规则