接入物联网数据

功能概述

在接入物联网数据时，Wyn三种高效的数据传输模式：MQTT、HTTP与WebSocket。

MQTT：一种轻量级的发布/订阅模式协议，特别适用于资源受限的环境或网络条件不稳定的场景。通过“订阅”机制，仅接收需要的主题消息，从而大幅节省带宽与能耗，实现高效的信息交换。
HTTP：互联网上应用最为广泛的一种网络协议。在物联网场景下，我们采用HTTP轮询的方式，由设备定期向服务器发起请求，获取最新的状态更新或控制指令。这种方式适合于数据更新频率较低的应用，保证了数据的准确性和安全性。
WebSocket：提供了一种全双工的通信渠道，允许服务器主动推送数据至客户端，无需客户端频繁请求。这种模式特别适用于需要持续接收消息的场景。

对以上三种模式，可根据您当前的系统可选择最适合的数据接入方式。

在接入物联网数据时，您需要填写连接信息、消息模板、以及根据消息模板来设计我们要在仪表板中消费的虚拟实体。

本节我们将为您介绍如何接入一个简单的物联网数据并对其进行管理，后续的小节为您详细介绍在设计器中的具体操作。

在文档门户首页，单击加号，选择仪表板下的准备数据。

在准备数据页面，滚动条拖到底部，点击创建物联网数据。

开始创建时，设计器分为三部分：

带红色星号的配置为必填项。

MQTT 协议的配置示例如下：

WebSocket 协议的配置示例如下：

HTTP 协议的配置示例如下：

连接类型	参数	是否必填	说明
MQTT	服务器地址	是	MQTT Broker地址和端口，主机名或IP地址，端口默认1883，也支持填写ws地址。示例: localhost 10.32.3.173
	主题	是	需要订阅的MQTT主题。
	用户名	否	开启匿名访问时可不填。
	密码	否	开启匿名访问时可不填。
	开启SSL/TLS加密	是	默认关闭，
	字符集	是	支持UTF-8、GBK、Big5三种字符集，默认字符集UTF-8。
WebSocket	接口地址	是	WebSocket只需要填写接口地址。
HTTP	端点地址	是
	请求方法	是	可选GET和POST，默认是GET。
	地址请求头	否	为当前选择的端点地址配置请求头，可添加 Http 头字段，可设置字段名称和字段值。
	有效载荷	否	当使用 POST 请求方法时，可根据需要传输数据的类型设置有效载荷。我们给出了三种选项：none, raw, x-www-form-urlencoded
	Raw类型	否	当有效载荷选择raw时，可选择raw类型，有五种选项：text、javascript、json、html、xml。

可通过单击页面上方菜单栏中保存按钮旁边的测试连接按钮来测试配置的连接信息是否正常。

必须填完必填项才可点击测试连接按钮。

连接成功后，单击确定按钮。

在文本框中输入示例消息，消息模板的内容必须和接收的消息格式一致。

输入不合法的JSON会有警告或错误提示。

输入JSON文本后可以单击下方JSON格式化按钮，使输入框中的内容更友好的展示。

点击示例消息输入框下方的设计虚拟实体按钮。在右侧将出现示例消息的结构

JSON树

选中消息结构中的一个或多个节点，点击消息结构下方的按钮添加到虚拟实体。

创建虚拟实体

type=warning
如果有选中的节点在数组节点下，在单击添加到虚拟实体时，需要为选中的数组节点添加过滤器，详情请参考添加过滤器。

将选中的JSON的节点添加到虚拟实体中后，在虚拟实体的卡片中会呈现出这个属性的值，值的数据来自于示例消息中的JSON文本。

虚拟实体中属性的数据类型就来自于系统对于属性的值的推断。

以我们的示例消息为例：

属性	值	类型	推断理由
deviceId	device001	字符串	包含数字字母或其它字符，无法转换为其它类型的是字符串。
timestamp	2023-07-08T14:30:00Z	日期时间	格式符合ISO 8601标准，通常用于表示具体的日期和时间。在Wyn中，这种格式的数据通常会被解析为日期时间类型。
temperature	25.3	数字	浮点数和整数都是数字类型。
battery	82	数字	浮点数和整数都是数字类型。
online	true	布尔	值为true和false时是布尔类型。