Skip to content

第二章 组件一览 ​

组件很多,但常用的就十来个。先看这一页,知道“我想做的效果该用哪个”,细节可以后面再查。

1. 按用途分成六类 ​

类别用来做什么常见组件
开关控制开/关、启用/停用开关、切换、锁
连续调节调亮度、速度、温度滑块、滑动条、档位器
数值输入填一个数字、选一个值数值框、下拉、选择按钮
数据显示看设备发来的值数值、文本、键值、进度、仪表、水位、圆环
图表记录看一段时间的变化曲线图
时间相关倒计时、定时任务倒计时、定时器

2. 常用组件 ​

组件适合做什么设备要做什么
开关灯、继电器、启停收到 1/0 就开/关;状态变了也可以回传
滑块亮度、速度、角度收到 0~100 之类的数值
档位器风扇几档、模式几档收到档位对应的值
数值框设定温度、输入参数收到数字
下拉 / 选择按钮几个固定选项里选一个收到选项的值
方向键 / 摇杆遥控方向、连续坐标方向键收按键动作;摇杆收 joyX/joyY(±1024)或 jAngle/jDist
数值 / 文本显示设备发来的数字或文字把值发给页面
发送文本点一下发一段固定内容,或让用户临时输入再发按收到的内容执行,不需要回传
文本组多行预设内容,点哪行发哪行(设置里增删)同发送文本;不是运行时可动态加行
接收框显示设备发来的原始通知(含鉴权握手)和页面发出的内容,可切文本/hex只管发;页面只显示,不回推
定时器到点让设备自动执行(每天/每周/间隔/延时)BLE 由设备本地执行并回执行记录
日志显示设备/云端上报的运行日志设备按需发日志帧(BLE 用 L 帧)
设备状态在线、信号、电量等汇总应用侧维护,设备通常只需上报电量
设备信息设备名称、型号等应用/云端填充,设备不用发
视频播放设备提供的视频流仅 WiFi / 物联项目;蓝牙项目不可用
进度 / 仪表 / 水位显示百分比、刻度把 0~100 或量程内的值发给页面
状态指示灯红/绿/黄状态发一个状态值,页面按配置显示颜色
曲线图温度、湿度的历史曲线按时间点发数据,页面负责画线
倒计时倒计时、延时动作按 start_ms / pause_ms / reset_ms 收发

支持「发送前确认」的组件:开关、切换、锁、按钮,以及文本组的每一行。

3. 三类“方向”要分清 ​

方向意思例子
页面 → 设备你操作,设备执行点开关、拖滑块
设备 → 页面设备上报,页面显示温度、电量、状态
双向两边都能改开关:你点它,设备也能回传真实状态

方向在组件描述里会标成 out / in / inout,对应上面的三种。

4. 新手最容易选错的三个 ​

想要的效果别选应该选
显示“开/关”文字文本开关(或切换)
显示一个百分比数值进度 / 仪表 / 水位
看一小时内的温度变化数值曲线图

5. 平台差异 ​

有些组件不是三个平台都有:

组件蓝牙WiFi物联
视频❌✅✅
指南针 / 力感应✅✅❌
倒计时✅❌❌
曲线图✅ 设备发数据✅ 云端取数据✅ 云端取数据
定时器✅ 设备本地执行✅ 云端配置✅ 云端配置

判断方法:组件列表里看不到,就是当前项目类型不支持;已经放在页面里的实例仍会显示,但不建议继续使用。

6. 组件放好之后 ​

每个组件都要有一个字段名,设备靠这个名字认它。下一章讲怎么起名、怎么避免冲突。