19:00
A1

智能水族箱15L

A2
25 °C
鱼缸当前水温
A3

水族箱异常告警

检测到水温过高,建议您加热棒断电

A4

电源开关

已关闭

A5

灯光设置

自定义灯光颜色与模式

01 艳红
02 极光
03 暖黄
04 白光
05 暖灯
06 月光
07 流光
自定义

页面定位 & 作用

  • 本页是水族箱设备维度的「控制中枢」,聚合当前水族箱的关键状态展示 + 主要控制入口 + 异常提醒。
  • 用户日常打开频率最高的页面之一,需要做到「一眼看到当前状态,核心操作不怕点错」。

信息结构 & 上下游

  • 上半区:当前水温大数字 + 环境状态提示 + 潜在告警(见 A2、A3)。
  • 中部:电源总开关、灯光设置等关键控制模块(见 A4、A5),后续可扩展水泵/喂食等卡片。
  • 入口:主要来自首页设备卡片/家庭设备列表/消息中心告警详情;下游跳转至更多设置(Q-08)、灯光控制(Q-03)等子页面。

交互 & 路由

  • 返回按钮:点击返回上一层「水族箱设备列表 / 设备卡片」页面,保留上一次列表滚动位置。
  • 标题文案:展示当前设备名称(支持多设备),与设备详情页标题保持一致;从设备列表进入时带入设备名。
  • 更多设置:点击跳转至「更多设置」页面(页面 ID:Q-08),包括固件升级、设备信息、移除设备、共享等功能入口。

状态 & 异常

  • 离线态:若设备离线,则标题右侧追加「离线」标签,点击更多设置时仍可进入但部分操作置灰。
  • 多家庭/多设备:标题不显示家庭名称,仅显示设备名;家庭切换逻辑统一在首页/家庭选择中处理。

展示规则

  • 实时水温:展示当前 DP 上报的实时水温,单位为摄氏度(°C),小数按 1 位四舍五入(例如 25.3 → 25.3,25.34 → 25.3)。
  • 刷新策略:水温 DP 变更时实时刷新;若 30s 内无 DP 更新,则保持 zuletzt 显示值,不展示 Loading。
  • 单位固定:当前仅支持 °C,不做中英文切换;若后续支持 ℉,需在全局设置中统一切换。

阈值 & 文案

  • 正常区间:默认 22–28°C 为正常范围,标签文案为「鱼缸当前水温」,圆点为绿色。
  • 偏低/偏高:超出正常区间但未触发告警时,仅改变标签文案:
    • 低于 22°C:文案「水温偏低,注意保温」
    • 高于 28°C:文案「水温偏高,注意降温」
  • 与告警联动:当存在「水温异常」告警卡片(见 A3)时,下方文案保持与告警文案语气一致,避免信息冲突。

触发条件 & 源头

  • 触发逻辑:由后台/设备侧规则引擎根据水温 DP 与预设阈值计算后产出告警事件,App 仅负责展示。
  • 告警等级:当前样例为「高危级」告警,使用红色背景;中低等级可使用黄色/蓝色样式,具体在告警规范中统一。
  • 多条告警:若同时存在多条与本设备相关的未读告警,仅展示最新一条摘要,点击进入「消息中心/设备告警详情」。

交互行为

  • 整块卡片可点击,跳转至「水温/告警详情」页面(可统一走消息中心详情页)。
  • 若用户已在消息中心处理/确认告警,本卡片在重新进入页面时不再展示。
  • 不提供「忽略」按钮,避免与消息中心阅读状态冲突;统一在消息中心做已读/处理逻辑。

功能定义

  • 控制范围:作为设备级总开关,控制灯光、水泵、增氧等所有功能模块的供电状态。
  • 文案规则:根据 DP「设备开关状态」显示「已开启 / 已关闭」,与首页设备卡片状态保持一致。
  • 首次进入:从 DP 读取设备当前状态,不做默认假设。

交互 & 限制

  • 关闭确认:若当前存在运行中的定时任务(如喂食、灯光定时),关闭总开关时弹出二次确认,提示「关闭后相关定时任务将暂停执行」。
  • 与子开关关系:总开关关闭时,下方灯光/水泵等模块的开关视觉上保持「关闭」状态且不可操作(置灰 + 不响应点击)。
  • 失败反馈:若下发开关指令失败(网络/设备异常),通过 Toast 提示,并回滚开关状态显示。

模块职责

  • 灯光总开关:右上角开关仅控制灯光功能(不影响水泵),与总开关之间为「总控优先」关系(见 A4)。
  • 预设颜色:下方 8 个颜色点为产品预设灯光方案,包含名称与排序 ID(01~07,自定义)。
  • 当前选中:仅允许单选,选中项高亮(边框 + 投影),与 DP「当前灯光模式/色温」保持一致。

交互 & 后续入口

  • 点击任一颜色点,立即下发灯光控制指令;失败时通过 Toast 提示,并回退选中态。
  • 点击「自定义」进入灯光高级设置页面(页面 ID:Q-03),支持亮度、色温、动效等更细粒度配置。
  • 底部「更多设置」链接同样跳转至 Q-03 页面,主要面向需要查看定时/快捷场景的用户。

边界 & 异常

  • 设备不支持某些模式时(例如老款设备缺少「流光」),对应预设项不展示,避免误导。
  • 当总开关关闭或设备离线时,本模块整体置灰且点击无效,保持与顶部状态栏提示一致。

建议埋点

  • view_page_q02:进入本页时上报设备 ID、入口来源(首页卡片/消息中心/深链等)。
  • click_toggle_power:点击电源总开关,记录操作方向(ON/OFF)、结果(成功/失败)。
  • click_toggle_light:点击灯光开关,记录当前模式 ID、成功/失败。
  • click_light_preset:点击任一预设颜色,记录 preset_id、设备在线状态、结果。
  • click_alert_card:点击水温异常告警卡片,记录告警 ID、进入的告警详情页 ID。

测试要点

  • 多入口(首页、家庭列表、消息中心、深链)下的路由是否正确,返回逻辑是否符合预期。
  • 在线/离线、正常/异常、多告警共存等组合场景下,各模块文案与可用状态是否一致。
  • 弱网/断网时开关回滚逻辑是否生效,是否存在 UI 显示已开启但实际未执行成功的情况。
  • DP 长时间不更新、接口失败时是否有合理兜底(保留上次数据、不频繁弹错)。