ToB企服应用市场:ToB评测及商务社交产业平台

标题: 【乐吾乐3D可视化组态编辑器】数据接入 [打印本页]

作者: 前进之路 时间: 2024-6-28 15:05
标题: 【乐吾乐3D可视化组态编辑器】数据接入
数据接入

本文为您介绍3D数据接入功能，数据接入功能分为三个步骤：数据订阅、数据集管理、数据绑定
编辑器地址：3D可视化组态 - 乐吾乐Le5le
数据订阅

乐吾乐3D组态数据管理功能由次顶部工具栏中按钮数据管理打开。

在新弹窗中选择数据订阅标签，新建数据订阅

数据支持3种范例协议，HTTP、MQTT、WebSocket。HTTP模式下系统会按照设置的轮询隔断定时向后端地址发送哀求，MQTT和WebSocket则会等候后端推送数据。
数据订阅范例与参数

HTTP

名称：数据订阅的名称。
地址：后端接口地址。
方法：HTTP模式下哀求的方法。有Get和Post两种。
参数项：HTTP模式下哀求时携带的参数。支持哀求Header、Query、Body三种参数

MQTT

名称：数据订阅的名称。
地址：后端接口地址。
主题：MQTT模式下订阅的消息主题。
客户端ID：MQTT模式下设置的客户端ID。
用户名：MQTT模式下设置的用户名。
密码：MQTT模式下设置的密码。

WebSocket

名称：数据订阅的名称。
地址：后端接口地址。
子协议：WebSocket模式下指定的子协议，多个子协议用英文逗号分隔。

后端数据格式

目前我们支持两种返回格式：
1.数组Array<{ id: string; value: any; }>。其中，id为必要更新的数据点号，value为更新的值。比方：

[
{ id: 'd-1-a-001', value: 120 },
{ id: 'd-1-a-002', value: 60 },
{ id: 'd-1-a-003', value: '开启' },
{ id: 'd-1-a-004', value: false },
{ id: 'd-1-a-005', value: 30 },
{ id: 'd-1-a-006', value: 22.5 },]

复制代码

Copy
2.键值对{ [ id: string ]: any }。其中，键为必要更新的数据点号，值为更新的值。比方：

{
'd-1-a-001': 120,
'd-1-a-002': 60,
'd-1-a-003': '开启',
'd-1-a-004': false,
'd-1-a-005': 30,jian
'd-1-a-006': 22.5,}

复制代码

Copy

值的范例必要符合数据会合对应数据点号设定的数据范例。比方数据点号为'd-1-a-001'的数据点，它的数据范例为数值（整数），那么后端也应该推送数值范例的值，如果推送的是非数值，那么系统会强制将其转换为数值，比方推送的是布尔值true，系统会强制转换为1。

天生数据集

数据订阅完成之后，此时网页已经拥有吸取后端数据的能力，接下来必要将后端的每一条数据变成数据点。数据点的聚集称为数据集，后端接口的数据是数据点的数组聚集，数据点由数组中的每个数据的id构成数据点号，value大概值构成数据点的值。
天生数据点的方法有两种：新建数据点号、导入数据集
新建数据点号

打开数据管理弹窗后选择数据集标签，新建数据点号。

在新弹窗中设置数据点属性

数据点ID：数据点名称ID(为必填项)
装备名称：选填
数据点名称：选填
数据范例：包含字符串、整数、浮点值、布尔值
值：当前表现的默认数值
开启模仿：设置是否开启模仿数据
值范围：数据模仿的范围

（值的设置规则）

形貌：对当前数据点的形貌备注

设置完毕点击确认即可天生一条数据点

导入数据集

相较于单个新建数据点，导入数据集是更高效的方式；导入数据集支持三种方式：选择模板、在线数据、选择文件。

选择模板：选择右侧下拉框即可选择已生存的模板，快速打开数据集，前提为已有数据集信息被执行过生存为模板命令

。

在线数据：右侧输入在线接口地址点击图标

或回车获取数据。

选择文件：支持导入excel、json、csv格式文件。

生存数据集

生存当前数据集的方式有：生存为模板、下载JSON文件、下载EXCEL文件，当差异场景使用雷同接口时，可以从模板中或导入文件中获取数据点号，方便快速复用。

数据绑定

完成前两步新建数据订阅、天生数据集后，接着编辑末了一步数据绑定后即可完成数据接入。
新建动态数据

动态数据的载体分为面板、模型两类，数据绑定逻辑雷同，其主要运用场景差异，面板中绑定数据是以展示装备仪表的实时动态数据功能为主，如温度值、湿度值、压力值、功率、时间等具体数据的实时变化，当然也可以借此改变面板其它属性，如基本属性状态、动画状态等，只是现实运用场景不多；而模型中则是相反，依赖动态数据改变模型的属性状态、执行动作为主，如改变模型的根本属性状态、动画状态、自动员画状态以及自定义属性，下文将具体介绍其中差异。
面板

点击面板的数据标签，新建动态数据。

属性范例中包罗5种：【自定义】、【属性】、【自定义动画】、【自动员画】、【内容】，其中【内容】为面板绑定数据的主要功能（实时动态数据），为本节主要解说对象，其它四类详见下一小节模型的绑定数据教程。

内容（实时动态数据绑定）

新建编辑器内置面板，编辑文本信息，将必要举行数据绑定的文本框改为可辨认名称（绑定数据会用到此名称），编辑完成退出界面。

点击面板的数据标签，新建动态数据。

在属性范例中选择【内容】（【内容】为面板数据绑定中特有范例），属性下拉框中则可选择上一步设置了名称的文本框（未设置名称默以为：内容1）。

文本框内可选择文字、颜色，这里选择文字点击确认。

在数据标签界面点击回形针按钮，弹出数据点弹窗，选择第二步天生数据集中符合的数据点，点击确定完成绑定。

此时，在数据订阅接口地址连接上且为面板文本框绑定了数据点的情况下，实时动态数据就完成了绑定，点击运行即可在面板观测后台发送的实时数据。

属性、自定义动画、自动员画、自定义

详见下一节模型数据绑定
模型

模型中
点击模型的右侧数据标签，新建动态数据。

属性范例中也包罗5种，本节主要解说【属性】、【自定义动画】、【自动员画】、【自定义】的设置方法。

属性

具体可绑定属性为经纬度、海拔、是否开启、透明度、模型基本信息、材质等，可设置参数包罗当前值、过渡时间、过度模式。

这里以立方体的位置-X为例，设置完成后退回数据标签，点击回形针按钮绑定数据点，完成动态数据与立方体位置-X的绑定。这里必要注意的是物体属性值与数据点应为属性对应关系，否则不见效，如位置、缩放、旋转等信息应绑定浮点值、整数、字符串等表现为具体数值的数据点，如是否开启、开启辉光等则应绑定布尔值这种表现为只有true和false的数据点。

自定义动画、自动员画

如对象带有自定义动画或自动员画，则可以绑定数据的属性有：循环模式、循环次数、动画速率、竣事状态、时间段；

设置完成后返回数据标签，绑定数据点；属性与数据点的对应关系为数值，其中循环模式-数值（ 0 为不循环、1为单向循环、2为双向循环），竣事状态-数值（ 0为还原至开始值、1为保持瞬时值、 2为设置为竣事值）。

自定义

自定义属性是在以上属性范例无法满足数据绑定需求时，提供的用户扩展的业务属性。

数据下发与双向数据通信

数据订阅时可以设置参数项，设置完数据订阅后可以新建一个交互事件，选择触发范例后，在执行动作模块，将动作范例选择“订阅/发布数据”，并选择正确时数据订阅内容，即可将数据订阅时的参数如哀求头，哀求体中的参数发给后端。数据订阅、数据绑定、交互事件配合使用共同构成数据下发和双向数据通信的功能。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)