App 设备面板
App 设备面板是为设备类型定制的移动端控制界面。用户应用 App 中打开设备时,展示的就是该设备类型配置的面板。
在设备类型详情中点击「应用配置」页签,进入面板设计器。该页签同时提供「管理 App」入口(创建和管理通用版 App)与「用户添加设备」配置(WiFi 配网、设备二维码)。
面板设计器
在设备类型详情中点击「应用配置」页签,点击「打开编辑器」进入面板设计器。设计器是全屏的所见即所得编辑器:

编辑器分为四个区域:
- 左侧分类栏:按类别浏览全部组件(数值展示、数值控制、历史数据、开关状态、开关控制、文字展示、多状态控制、选择器、日期时间控制、色彩控制、图像视频、二维码、位置地图、属性下发、命令下发、任务运行、布局组件、跳转组件),括号中的数字为该类别下的组件个数。
- 组件面板:显示当前类别下的组件,每个组件带实时预览效果,点击「添加组件」把组件加入手机预览区。
- 手机预览区:实时展示 App 中的页面效果,支持多页(设备详情、分页 1…)与页面跳转配置。
- 预览面板:点击预览区中的组件后,在右侧配置「选择属性」(绑定物模型属性)、「属性设置」(显示名称、名称/数字颜色、单位开关、背景色开关、数字加粗、占用列数、数字区间样式)与「样式设置」(背景、圆角、内边距、字号等)。
编辑完成后点击顶部「保存」,配置会发布到该设备类型下的所有设备;「导出 / 导入」可以将面板配置导出为 JSON 备份,或从 JSON 恢复。
组件分类
平台内置多类面板组件,常用的包括:
- 数值展示:实时显示属性当前值,支持单位、小数位、图标和状态色;数值网格/图标数值网格可一次展示多个属性。
- 数值控制:以滑块、步进器等形式修改可写属性,支持下发确认与密码确认;含数值批量设置组件。
- 开关控制:布尔属性的开关控制。
- 多状态控制:枚举属性的档位切换,如"制冷/制热/除湿/送风"。
- 属性下发列表:按分组展示一组可下发属性,适合批量设置;另有带搜索、按参数编号分组的「查询属性列表下发」组件。
- 图表组件:属性历史曲线与实时曲线。
- 日期时间控制:定时列表、一次性倒计时、每日定时区间列表,以及时间/时长/日期/周期重复选择组件。
- 布局与跳转组件:页面分组、分页跳转等界面组织类组件。
生效范围
面板配置按设备类型存储,同类型设备共用一套面板。用户端的展示受应用配置约束(例如应用未开放"编辑设备信息"时,面板中的相应入口会隐藏)。
TIP
面板修改后如果用户端没有变化,让用户退出设备页重新进入即可加载新面板。
