第二章 组件一览
组件很多,但常用的就十来个。先看这一页,知道“我想做的效果该用哪个”,细节可以后面再查。
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. 组件放好之后
每个组件都要有一个字段名,设备靠这个名字认它。下一章讲怎么起名、怎么避免冲突。
