Thingsboard Widgets 开发教程

1. 项目介绍

本项目是基于Thingsboard平台的开源项目，旨在提供一系列自定义的Widgets，以丰富和扩展Thingsboard的监控和控制功能。Widgets包括开关、滑块、按钮、图表等，可用于创建更加直观和个性化的用户界面。

2. 项目快速启动

环境要求

• Thingsboard版本：大于3.0的版本，适用于Thingsboard CE、PE或Cloud。

安装步骤

1. 登录您的Thingsboard安装或Thingsboard.cloud账户。
2. 下载项目压缩包或克隆整个仓库到本地。
3. 将collibellex.json文件从项目中的Bundle目录复制到Thingsboard的Widget库中。
4. 在Thingsboard的Widget库中，选择“添加Widget包”，然后选择“导入Widget包”。
5. 将collibellex.json文件拖放到浏览器窗口中，完成Widget包的导入。

示例代码

以下是添加一个滑块Widget的示例代码：

{
  "type": "slider",
  "changeRequestMethod": "setValue",
  "rpcRequestTimeout": 500,
  "statusRequestMethod": "getValue",
  "minValue": 0,
  "maxValue": 100,
  "stepWidth": 1
}

3. 应用案例和最佳实践

应用案例

• 使用开关Widget控制设备的状态。
• 使用滑块Widget调整设备参数。
• 使用图表Widget展示实时数据。

最佳实践

• 在设计Widget时，考虑用户界面的易用性和美观性。
• 确保Widget的功能与实际业务需求相匹配。
• 在部署Widget前，进行充分的测试以确保稳定性和性能。

4. 典型生态项目

本项目的生态系统中，以下是一些典型的项目：

• Fluid Level Widgets：用于显示液体水平。
• Light Bulb Widget：用于控制灯光的开关。
• Gauge Widgets：用于展示各种指标的仪表盘。
• PV System Widgets：用于展示光伏系统的能量流动画。

通过这些Widgets，开发者可以为Thingsboard平台构建更加丰富和实用的监控界面。