TCPServerReceive TCP服务器接收
TCPServerReceive 算子用于接收TCP服务器消息,需配合资源算子 [TCPServerConnectionResource(TCP服务器连接资源)] 算子使用。
该算子能将 TCP服务器连接资源 算子收到的消息进行简单的处理,并输出对应结构的数据。
目前支持接收String、Pose、JointArray三种数据类型。 注意:只有符合指令的TCP消息才能触发该算子接收并处理。
算子参数
-
TCP资源名称/tcp_resource_name
:指定接收TCP消息的服务器资源算子。
算子面板
算子面板用于设定通讯过程中期望收到的消息指令和格式。
-
启用/Enable
:布尔类型,默认为勾选状态,该活动指令是否开启使用,如未勾选,则为禁用状态,不再响应该行指令 -
指令/Command
:字符串类型,默认为空,必填!不可为空!当收到的TCP消息开头内容与指令相同时,该条目对应的算子端口将被触发 -
指令分隔符/Command delimiter
:枚举类型,默认为NONE,可以为”NONE” “Space” “,” “.” “;” “!” “@” “#” “$”-
当该位为”NONE”时,将不处理指令分隔符。
-
当该位为”Space”时,指令和后续内容(如有)需要添加一个空格
-
当该位为其他字符时,指令和后续内容(如有)需要添加对应字符
-
若枚举中的字符不满足分隔符需要,可将分隔符位设为NONE,将期望的分隔符作为指令的一部分。(例如指令为”CAPTURE”,想使用”&”作为指令分隔符,可将指令改为”CAPTURE&”,指令分隔符为”NONE”)
-
-
包含数据/Contains data
:枚举类型,默认为empty,可以为”empty” “String” “Pose” “JointArray”。-
当值为”empty”时,即不包含数据,当收到指令内容时,将触发对应的Event信号
-
当值为”String”时,指令和指令分隔符(如有)后需跟随一段字符串,跟随的字符串内容将在触发对应的Event信号时赋值给对应的同名string类型端口。
-
当值为”Pose”时,指令和指令分隔符(如有)后需跟随一段表示Pose值的字符串,该字符串将按数据分割符解析成Pose数据类型,并在触发对应的Event信号时赋值给对应的同名Pose类型端口
-
当值为”JointArray”时,指令和指令分隔符(如有)后需跟随一段表示JointArray值的字符串,该字符串将按数据分割符解析成JointArray数据类型,并在触发对应的Event信号时赋值给对应的同名JointArray类型端口
-
-
数据分隔符/Data delimiter
:字符串类型,默认为”,”(逗号),该数据分隔符仅在包含数据Pose或JointArray时有效果,用于将收到的数据按此分隔符分割为数组并赋值为Pose或JointArray数据。该数据分隔符为字符串类型,因此可以使用” “(空格),”abc”(任意字符串),”!@#$%”(任意常见字符)。 -
后缀/Suffix
:字符串类型,默认为””(空字符串)。-
后缀为空时,收到指令消息时不检查后缀
-
后缀不为空时,收到的消息将按须包含具有相同字符串(否则报错),此后缀之后的内容将被忽略
-
-
备注/Remarks
:字符串类型,默认为””(空字符串),此处可添加对该行指令的说明,可使用中文。 -
活动信息(只读)/Last message(only read)
:字符串类型,只读,可选可复制,用于查看最近一次触发该命令时的TCP完整消息,便于调试。 -
删除/Delete
:按钮类型,点击后将删除这条指令。 -
➕/➕
:按钮类型,点击后将增加一条TCP通讯接收指令。 -
更新面板/Update Panel
:按钮类型,点击后刷新“活动信息”栏,便于调试。 -
应用/Application
:按钮类型,点击后将应用当前面板设定的消息指令方案,算子端口也会自动做出对应调整。
数据信号输入输出
输入: 该算子由 TCP服务器连接资源 算子所建立的TCP服务器接收到的信息触发,无需任何输入
输出: 该算子的输出由算子面板设定的数据类型确定。对于每条指令,都会包含对应指令名的输出信号端口(不包含指令分隔符)
-
如果该指令包含String数据,将会生成同指令名的String类型端口
-
如果该指令包含Pose数据,将会生成同指令名的Pose类型端口
-
如果该指令包含JointArray数据,将会生成同指令名的JointArray类型端口
功能演示
请参考 TCP服务器连接资源 功能演示。