Skip to content

第三章 字段与绑定 ​

这一章解决三个问题:字段叫什么、能不能重复、改了会怎样。

1. 字段是什么 ​

字段(bindKey)是页面和设备之间的暗号。

  • 页面上的开关叫 light
  • 设备收到 light:1 就知道“开灯”
  • 设备发 light:1 回来,页面上的开关就显示“开”

一个字段只对应一件事。不要把“温度”和“湿度”塞进同一个字段。

2. 在哪里改 ​

选中组件后,在右侧面板找到「数据」或「字段」区域,就能看到字段名,直接改。

有的组件有多个字段(比如电量有“电量”和“是否充电”),各改各的。

3. 起名规则 ​

规则正确错误
小写字母、数字、下划线light、temp1、pump_a灯光、temp-1
不使用空格living_roomliving room
同一页面内唯一switch1、switch2两个都叫 switch
简短、看得懂tempwoshiwendu1

不用追求“专业”,能让设备端一眼看懂就行。

4. 重复会怎样 ​

同一页面出现两个同名字段时:

  • 你动其中一个,另一个也可能跟着变
  • 设备收到一个值,不知道该给谁
  • 图表、历史数据会混在一起

复制组件时最容易出现这个问题:复制出来的组件会带着原来的字段名,记得改掉。

如果两个组件本来就是同一个东西的两种显示(比如数值和仪表都显示温度),可以共用一个字段——前提是你清楚这是故意的。

5. 改了字段会怎样 ​

改动影响
只改标题、颜色不影响设备
改字段名设备代码、AI 生成的固件、图表配置都要跟着改
删掉组件设备再发这个字段就没人接;历史数据还在
换组件类型但字段名不变设备基本不用改,页面显示方式变了

所以:字段名定下来之后尽量别改。确实要改,就把它当成“删旧的 + 加新的”。

6. 方向和范围 ​

  • 方向(页面发设备 / 设备发页面 / 双向)一般跟着组件类型走,不用手改
  • 范围(最小值、最大值、小数位)决定设备发来的值怎么显示
    • 比如滑块设 0~100,设备发 50 就显示一半
    • 设了范围但设备发超出的值,页面会按边界显示,不会报错

7. 改完检查一遍 ​

  • [ ] 每个字段都有名字,没有空的
  • [ ] 没有两个组件用同一个字段(除非故意)
  • [ ] 字段名只用小写字母、数字、下划线
  • [ ] 范围设置和实际设备输出一致(比如温度是 -40~80)