第一章 怎么使用自定义页面
这一章只做一件事:让你在 10 分钟内做出一个能用的页面。
1. 自定义页面是什么
自定义页面就是你自己拼出来的一块手机界面:放开关、滑块、数值、图表,然后让设备和这些控件“对上话”。
- 控件长什么样 → 你决定
- 控件叫什么名字(字段)→ 你决定
- 设备怎么收发 → 见《用 AI 生成固件》或协议文档
2. 打开页面编辑器
- 打开控制台:https://xsgee.com
- 进入你的项目(蓝牙项目就选蓝牙项目,别选成 WiFi/物联)
- 左侧菜单点「自定义页面」
- 找到要编辑的页面,点「操作」→「编辑」
打开后就是编辑器,左边是组件库,中间是画布,右边是设置。
3. 认识三个区域
| 区域 | 做什么 |
|---|---|
| 左侧组件库 | 选组件,拖到中间 |
| 中间画布 | 摆位置、调大小,看到的就是手机上的样子 |
| 右侧设置 | 改文字、颜色、范围,以及字段名 |
新手只需要记住一句话:左边拖出来,中间摆好,右边改字段。
4. 放第一个组件
以「开关」为例:
- 左侧找到「开关」,按住拖到画布
- 中间调整位置和大小
- 右侧把标题改成你要的文字,例如“客厅灯”
- 右侧找到字段(有的版本叫“绑定字段”),填一个好记的名字,例如
light
这时页面已经能显示了,但设备还不会理它——因为设备还不认识 light 这个名字。
5. 字段名是设备和页面的暗号
字段名(文档里也叫 bindKey)就是暗号:
- 页面上写
light,设备就要处理light - 一个页面里不能有两个同名字段,否则设备分不清
- 建议只用小写字母、数字、下划线,例如
light、temp1、pump_a - 定好之后尽量别改;改了设备代码也要跟着改
6. 保存并查看
- 点右上角「保存」
- 打开手机上的「小机云蓝牙」APP 或小程序
- 连接设备,进入这个页面
如果页面能正常显示、按钮能点,说明页面本身没问题;设备有没有反应,取决于设备固件有没有处理这些字段。
7. 页面密码(可选)
如果不想让所有人都能打开这个页面,可以设置画布密码:
- 打开页面编辑器
- 在页面配置里找到「画布密码」
- 设置密码,并按需设置「密码校验时间」
「密码校验时间」的含义:
| 值 | 效果 |
|---|---|
0 | 每次重连都要重新输入 |
| 大于 0(分钟) | 断线不超过这个时间,重连后不用再输 |
两点说明:
- 密码只在打开页面时校验,和连接设备、固件都没有关系
- 它是页面级保护,不是设备级加密;设备端不需要处理
8. 接下来读什么
| 想做什么 | 看哪一章 |
|---|---|
| 知道有哪些组件、各自能干什么 | 第二章 组件一览 |
| 搞清楚字段怎么起名、怎么不冲突 | 第三章 字段与绑定 |
| 让设备的数据真的显示出来 | 第四章 和设备对上 |
| 页面不生效、设备没反应 | 第五章 常见问题 |
如果你想让 AI 直接写设备固件,先读《用 AI 生成固件》,它会告诉你需要复制哪两份材料。
