Skip to content

第一章 怎么使用自定义页面 ​

这一章只做一件事:让你在 10 分钟内做出一个能用的页面。

1. 自定义页面是什么 ​

自定义页面就是你自己拼出来的一块手机界面:放开关、滑块、数值、图表,然后让设备和这些控件“对上话”。

  • 控件长什么样 → 你决定
  • 控件叫什么名字(字段)→ 你决定
  • 设备怎么收发 → 见《用 AI 生成固件》或协议文档

2. 打开页面编辑器 ​

  1. 打开控制台:https://xsgee.com
  2. 进入你的项目(蓝牙项目就选蓝牙项目,别选成 WiFi/物联)
  3. 左侧菜单点「自定义页面」
  4. 找到要编辑的页面,点「操作」→「编辑」

打开后就是编辑器,左边是组件库,中间是画布,右边是设置。

3. 认识三个区域 ​

区域做什么
左侧组件库选组件,拖到中间
中间画布摆位置、调大小,看到的就是手机上的样子
右侧设置改文字、颜色、范围,以及字段名

新手只需要记住一句话:左边拖出来,中间摆好,右边改字段。

4. 放第一个组件 ​

以「开关」为例:

  1. 左侧找到「开关」,按住拖到画布
  2. 中间调整位置和大小
  3. 右侧把标题改成你要的文字,例如“客厅灯”
  4. 右侧找到字段(有的版本叫“绑定字段”),填一个好记的名字,例如 light

这时页面已经能显示了,但设备还不会理它——因为设备还不认识 light 这个名字。

5. 字段名是设备和页面的暗号 ​

字段名(文档里也叫 bindKey)就是暗号:

  • 页面上写 light,设备就要处理 light
  • 一个页面里不能有两个同名字段,否则设备分不清
  • 建议只用小写字母、数字、下划线,例如 light、temp1、pump_a
  • 定好之后尽量别改;改了设备代码也要跟着改

6. 保存并查看 ​

  1. 点右上角「保存」
  2. 打开手机上的「小机云蓝牙」APP 或小程序
  3. 连接设备,进入这个页面

如果页面能正常显示、按钮能点,说明页面本身没问题;设备有没有反应,取决于设备固件有没有处理这些字段。

7. 页面密码(可选) ​

如果不想让所有人都能打开这个页面,可以设置画布密码:

  1. 打开页面编辑器
  2. 在页面配置里找到「画布密码」
  3. 设置密码,并按需设置「密码校验时间」

「密码校验时间」的含义:

值效果
0每次重连都要重新输入
大于 0(分钟)断线不超过这个时间,重连后不用再输

两点说明:

  • 密码只在打开页面时校验,和连接设备、固件都没有关系
  • 它是页面级保护,不是设备级加密;设备端不需要处理

8. 接下来读什么 ​

想做什么看哪一章
知道有哪些组件、各自能干什么第二章 组件一览
搞清楚字段怎么起名、怎么不冲突第三章 字段与绑定
让设备的数据真的显示出来第四章 和设备对上
页面不生效、设备没反应第五章 常见问题

如果你想让 AI 直接写设备固件,先读《用 AI 生成固件》,它会告诉你需要复制哪两份材料。