流程控制

单路判断

条件判断节点属于If判断条件节点。当满足设定条件时，抛出满足事件。

使用场景

例如，根据开关状态触发图层的显示效果场景。可以通过单路判断节点来判断当前开关的状态。处于打开状态，则显示图层。

使用方法

添加单路判断节点至蓝图画布中，可查看单路判断节点支持的事件/动作，以及配置参数。添加方式请参见使用逻辑节点。

节点配置

判断条件配置，可采用可视化界面和代码编辑两种方式。

• 可视化编辑：选择并且模式以满足全部条件，选择或者模式以满足任一条件。

• 代码编辑：通过新增数据过滤器的方法编写过滤条件，返回结果为BOOLEAN型。返回结果为TRUE时抛出条件满足时事件。可以添加多个数据过滤器。

锚点配置

事件/动作参数说明

条件判断

条件判断节点属于If-Else判断条件节点。当满足设定条件时，抛出满足事件，不满足设定条件，抛出不满足事件。

使用场景

例如，根据开关状态触发两个图层的显隐效果场景。可以通过条件判断节点来判断当前开关的状态。处于打开状态，则仅显示图层A；处于关闭状态，则仅显示图层B。

使用方法

添加条件判断节点至蓝图画布中，可查看条件判断节点支持的事件/动作，以及配置参数。添加方式请参见使用逻辑节点。

节点配置

配置项说明

锚点配置

事件/动作参数说明

多路判断

多路判断节点属于Case-When节点。通过对上游节点的输出结果进行判断，触发第一个满足条件的下游节点执行对应动作。

使用场景

例如，根据数字输入框内，当前的输入值设置地图散点的颜色。可通过多路判断节点，判断当前的输入值处于哪个范围，进而触发散点颜色的设置。例如在配置项中设置，当数值大于100时，为红色；50~100之间，为黄色；小于50，为蓝色。

使用方法

添加多路判断节点至蓝图画布中，可查看多路判断节点支持的事件/动作，以及配置参数。添加方式请参见使用逻辑节点。

事件/动作参数说明

配置项说明

计时器

计时器节点支持延迟定时、定点定时、循环延时定时和循环周期定时。

使用场景

计时器适用于需要定时的场景需求。当时间计数到达配置项设定的时间点时，计时器节点抛出当到计时点时事件，输出上游节点的输出结果，触发后续动作。

使用方法

添加计时器节点至蓝图画布中，可查看计时器节点支持的事件/动作，以及配置参数。添加方式请参见使用逻辑节点。

节点配置

配置项说明

锚点配置

事件/动作参数说明

序列执行

序列执行节点属于顺序执行节点。通过对上游节点的输出结果进行当前方法过滤后，再传递给下游节点执行对应动作。

使用场景

例如，当您需要切换不同场景的数据面板时，每个场景有很多数据面板，先把场景A相关的数据面板切出，再把场景B相关的数据面板切进。可使用序列执行节点，对不同场景的数据面板进行分组，再按照先A后B的顺序执行。

使用方法

添加序列执行节点至蓝图画布中，可查看序列执行节点支持的事件或动作，以及配置参数。添加方式请参见使用逻辑节点。

事件或动作参数说明

配置项说明

websocket节点

websocket节点为屏间通信节点。每个消息由消息名称和数据组成，消息名称在配置项中自定义，数据为上一个节点的输出结果。

使用场景

websocket节点用于多端之间的命令和数据传输。例如大屏与移动端、大屏与触摸屏端的数据传输等。

使用方法

添加websocket节点至蓝图画布中，可查看websocket节点支持的事件/动作，以及配置参数。添加方式请参见使用逻辑节点。

节点配置

配置项说明

锚点配置

事件/动作参数说明

自建socket服务

我们提供了DataV-WS工具包来自建服务，具体操作请参见如何使用DataV-WS服务。自建的websocket服务需要符合以下格式。

配置示例

注册消息

websocket节点发送消息格式如下。

{
  event: "register",
  data: {
    sid: "407194",                                      //屏幕的ID
    name: "数据源受控模式测试",                        //屏幕的名称
    group: "默认分组"                                 //默认分组
  },
  callback: "callback_15832235175585251131307383912" //当前注册时间戳，自动生成
}

websocket节点服务获取注册消息之后，需返回如下消息才能成功注册。

{
  event: "callback_15832235175585251131307383912",   //返回与之前同样的注册时间戳
  data: {
    isError: false,                                  //置为false
    data: "ok"
  }
}

发送消息

websocket节点发送消息格式如下。

{
  event: 'broadcast',
  data: {
    event: "发送出去的消息1",                         //发送消息名称
    data: {}                                         //data为任意格式
  }
}

接收消息

websocket节点接收消息格式如下。

{
  event: "broadcast_接收到的消息1",                  //broadcast_${接收消息名称}
  data: {}                                          //data为任意格式
}

问题排查

无法正常连接websocket的服务端时，可根据以下步骤排查问题：

1. WS服务不能直接在HTTPS协议下访问，需要用WSS服务，在使用自己的SSL证书去代理WS服务地址后，才能在HTTPS下访问。

2. 使用功能键F12，打开浏览器调试页面，查看浏览器network页签下的WS标签连接提示信息，检查是否因跨域未配置以及在连接返回的response的header里是否有设置Sec-WebSocket-Protocol为echo-protocol。

3. 连接成功后，根据文档中的消息格式传递参数即可。

websocket-pro节点

websocket-pro节点为屏间通信节点，相较于websocket节点，它提供了更精细的配置选项，可以更好地控制屏间通信的细节。与websocket节点一致，每个消息由自定义的消息名称和上一个节点输出的数据组成。

使用场景

与websocket节点相同，websocket-pro节点用于多端之间的命令和数据传输。

使用方法

添加websocket-pro节点至蓝图画布中，可查看websocket-pro节点的配置参数。添加方式请参见使用逻辑节点。

节点配置

配置项说明

锚点配置

事件/动作参数说明

自建socket服务

我们提供了DataV-WS工具包来自建服务，具体操作请参见如何使用DataV-WS服务。自建的websocket服务需要符合以下格式。

配置示例

注册消息

websocket-pro节点发送消息格式如下。

{
	"source":"407194",
	"target":["10000","20000"]
	"data":{
		"name":"数据源受控模式测试",
		"group":"默认分组",
		"hasCbMsg":true,
		"disconnectTime":60000
	},
	"event":"register"
}

websocket-pro节点服务获取注册消息之后，需内部处理注册消息。如注册成功，再由客户端的hasCbMsg参数决定是否需要发送到接收端。如10s内客户端没有注册成功，断开该客户端连接。发出的消息格式如下：

{
  "event":"register",
  "source":"407194",
  "data":{
    "isError":false,
    "data":"ok"
  }
}

心跳检测

websocket-pro节点开启心跳检测时，需要的应答格式如下。

{
  "event": "heartbeat",
  "data": {
    "group": "默认分组",
    "hasCbMsg":true,
    "disconnectTime": 60000
  }
}

发送消息/接收消息

websocket-pro节点发送/接收消息结构一致，格式如下。

{
  "event":"send_test",
  "source":"407194",
  "target":["10000","20000"],
  "data":{
    "zoom":12
  }
}