[1. RPC Call Reply 节点简介](#1. RPC Call Reply 节点简介)
[2. 节点配置](#2. 节点配置)
[2.1 基本配置示例](#2.1 基本配置示例)
[3. 使用场景](#3. 使用场景)
[3.1 设备控制](#3.1 设备控制)
[3.2 状态查询](#3.2 状态查询)
[3.3 命令执行](#3.3 命令执行)
[4. 实际项目中的应用](#4. 实际项目中的应用)
[4.1 项目背景](#4.1 项目背景)
[4.2 项目需求](#4.2 项目需求)
[4.3 实现步骤](#4.3 实现步骤)
[5. 总结](#5. 总结)
引言
ThingsBoard 是一个开源的物联网平台,提供了设备管理、数据收集、处理和可视化等功能。规则链是 ThingsBoard 中的一个强大功能,允许用户定义复杂的业务逻辑来处理设备上报的数据。在规则链中,
RPC Call Reply
节点用于回复远程过程调用(RPC)请求,这对于实现实时交互和设备控制非常有用。
1. RPC Call Reply 节点简介
RPC Call Reply
节点的主要作用是在规则链执行过程中回复远程过程调用(RPC)请求。通过 RPC Call Reply
节点,可以将处理结果发送回发起 RPC 请求的客户端或设备,实现双向通信和实时交互。这在设备控制、状态查询和命令执行中非常有用。
2. 节点配置
- 请求ID:指定要回复的 RPC 请求的 ID,通常从消息中获取。
- 响应内容:设置要发送的响应内容,可以是静态值、动态表达式或消息中的属性。
2.1 基本配置示例
{
"requestId": "${msg.rpcRequestId}",
"response": {
"status": "SUCCESS",
"result": "${msg.result}"
}
}
3. 使用场景
RPC Call Reply
节点在多种场景下都非常有用,特别是在需要实现实时交互和设备控制时。以下是一些具体的应用场景:
3.1 设备控制
在设备控制系统中,需要根据用户的指令控制设备的状态,例如开关灯、调节温度等。通过 RPC Call Reply
节点,可以将控制结果反馈给用户。
{
"requestId": "${msg.rpcRequestId}",
"response": {
"status": "SUCCESS",
"result": "Light turned on"
}
}
3.2 状态查询
在状态查询系统中,需要根据用户的请求查询设备的状态,例如当前温度、湿度等。通过 RPC Call Reply
节点,可以将查询结果反馈给用户。
{
"requestId": "${msg.rpcRequestId}",
"response": {
"status": "SUCCESS",
"result": {
"temperature": "${msg.temperature}",
"humidity": "${msg.humidity}"
}
}
}
3.3 命令执行
在命令执行系统中,需要根据用户的指令执行特定的操作,例如重启设备、更新固件等。通过 RPC Call Reply
节点,可以将执行结果反馈给用户。
{
"requestId": "${msg.rpcRequestId}",
"response": {
"status": "SUCCESS",
"result": "Device restarted successfully"
}
}
4. 实际项目中的应用
下面是一个实际项目中的例子,展示如何在智能家居系统中使用 RPC Call Reply
节点。
4.1 项目背景
假设我们正在开发一个智能家居系统,该系统需要支持用户通过手机应用控制家中的灯光、空调等设备,并查询设备的状态。此外,还需要实现实时反馈,确保用户能够及时了解操作结果。
4.2 项目需求
- 支持用户通过手机应用控制家中的灯光、空调等设备。
- 支持用户查询设备的状态,例如当前温度、湿度等。
- 实现实时反馈,确保用户能够及时了解操作结果。
4.3 实现步骤
-
部署设备:
- 在家中安装智能灯光、空调等设备,并连接到 ThingsBoard 平台。
-
创建规则链:
- 添加
RPC Call Reply
节点,用于回复 RPC 请求。 - 添加其他处理节点,如设备控制、状态查询和数据存储。
- 添加
-
配置规则链:
- 配置
RPC Call Reply
节点,回复控制灯光的 RPC 请求。
{
"requestId": "${msg.rpcRequestId}",
"response": {
"status": "SUCCESS",
"result": "Light turned on"
}
} - 配置
-
配置
RPC Call Reply
节点,回复查询温度的 RPC 请求。{
"requestId": "{msg.rpcRequestId}", "response": { "status": "SUCCESS", "result": { "temperature": "{msg.temperature}",
"humidity": "${msg.humidity}"
}
}
}
-
处理数据 :
- 根据用户的指令,控制设备的状态并生成响应。
// 控制灯光的 RPC 方法
public void controlLight(String action) {
if ("on".equals(action)) {
// 打开灯光
turnOnLight();
sendRpcReply("SUCCESS", "Light turned on");
} else if ("off".equals(action)) {
// 关闭灯光
turnOffLight();
sendRpcReply("SUCCESS", "Light turned off");
}
}// 发送 RPC 回复
private void sendRpcReply(String status, String result) {
JsonNode response = JsonNodeFactory.instance.objectNode()
.put("status", status)
.put("result", result);
rpcCallReplyNode.reply(msg.getRpcRequestId(), response);
} -
前端界面:
- 开发一个前端界面,显示设备的状态和控制按钮。
- 提供一个界面,让用户能够查看和管理设备的状态。
-
数据查询:
- 使用 ThingsBoard 的 REST API 或 GraphQL 查询,获取历史数据和控制记录。
GET /api/plugins/telemetry/DEVICE/{deviceId}/values/timeseries?keys=temperature,humidity&startTs={startTimestamp}&endTs={endTimestamp}
5. 总结
RPC Call Reply
节点在 ThingsBoard 规则链中是一个非常有用的工具,可以帮助回复远程过程调用(RPC)请求,实现实时交互和设备控制。通过合理地使用RPC Call Reply
节点,可以更好地管理和自动化系统中的各种操作。无论是在智能家居、工业监控还是其他物联网应用中,RPC Call Reply
节点都能发挥重要作用。
🌐 项目地址
Things Vuehttp://thingsvue.tpson.cn:7772/#/login?redirect=/tb-home/index
账号:admin@thingsboard.org
密码:admin123456
🎽 安装使用
获取项目代码: