发送数据指令

发送指令是指将数据通过通信接口下发到设备。

操作步骤

1. 添加交互事件

选中图元（例如按钮），在右侧属性面板切换到“交互”选项卡。选择“单击”事件，动作类型选择“发送数据”。

2. 配置通信方式

下发通信支持 HTTP、WebSocket、MQTT 三种通信方式。

如果实时数据通信建立了数据源，可以选择下发到指定的数据源（一般是 MQTT/WebSocket 通信）。

3. 通信配置

请求头

支持配置 JSON 格式数据，支持动态参数。例如：{"Authorization": "Bearer ${token}"}。 动态参数获取优先级：路径参数 > 本地存储 (localStorage) > cookie。

请求体

可以自定义添加多条参数名和参数值，最终组合成 JSON 格式发送。

• 参数名：自定义 Key 名，例如 "on"。

• 参数值：可以填写固定值。
• 关联数据：如果需要发送其他图元的数据，可以点击关联按钮，选择指定的图元及属性。

注意：

• 如果是 GET 请求，将会把数据添加到请求参数。
• 如果是 POST 请求，将会把数据作为请求体发送。

HTTP 回调

针对 HTTP 协议的下发（数据请求），支持编写 JavaScript 回调脚本，根据业务逻辑处理返回结果。

回调脚本可以获取以下三个参数：

1. data: 接口返回的数据。
2. context: 上下文，包含 meta2d 对象，可以调用核心库 API。
3. pen: 当前图元对象。

示例脚本

// 示例：打印返回数据
console.log("接口返回数据:", data);

// 示例：根据返回结果修改图元属性
if (data.success) {
  pen.text = "发送成功";
} else {
  pen.text = "发送失败";
}

更多示例

通过 ThingsBoard 给设备下发 RPC

了解如何通过 ThingsBoard 平台给设备下发单向或双向 RPC 指令。