通信

UDP服务端

绑定本地 UDP 端口提供启动、接收与停止操作，接收可按长度前缀、分隔符或原始数据报组帧，记录最近数据、发送方与帧数，失败返回 -1，运行信息写明原因
UdpServerTool · v1.0 · by system

输入参数 8

名称	keyId	类型	默认值	可连接	说明
通信配置ID	`commId`	enum	（空）	否	填入 HardwareConfig 中通信配置条目的 ID 后，工具改用该 ID 对应的常驻 UDP socket，启动、接收与停止共享同一句柄；留空时由本工具自行创建并绑定 socket，端口等参数按界面填写值解析
监听端口	`localPort`	int	9001	否	服务器要绑定的本地 UDP 端口，取值 1 到 65535，默认 9001；start 时该值缺失或超出范围会返回 -1 并在运行信息提示端口非法，绑定地址为本机全部网卡，recv 未启动时也会尝试按此端口自动绑定
操作	`operation`	enum	start	否	选择本次执行的动作，默认 start 绑定端口并启动监听；recv 收取一个数据报并解帧，stop 关闭 socket 并结束监听；填写这三种之外的取值会返回 -1 并在运行信息提示未知操作
超时(ms)	`timeoutMs`	int	3000	否	recv 操作等待数据报的超时时间，单位毫秒，默认 3000；取值小于等于 0 时按 3000 处理，等待期间没有数据到达会返回 -1 并在运行信息提示接收超时，start 与 stop 不使用该值
接收缓冲区	`bufferSize`	int	65535	否	recv 操作单次接收所用的缓冲区字节数，默认 65535；工具会把它限制在 1 到 65507 之间，小于 1 按 1、超过 65507 按 65507 处理，缓冲区按需分配，实际接收字节数不超过该上限
组帧模式	`frameMode`	enum	raw	否	recv 收取数据报后的解析方式，默认 raw 直接把整个报文作为数据、不组帧；delimiter 按分隔符切帧，length-prefix 按长度字段切帧，这两种模式会输出解析帧数并取首帧作为数据；取值拼写出错或组帧配置非法会返回 -1 并在运行信息提示组帧参数错误
长度字段字节数	`lengthFieldBytes`	int	4	否	length-prefix 模式下长度字段占用的字节数，默认 4，可选 1、2、4、8；该值决定解帧时从报文头部读取多少字节作为后续载荷长度，仅在长度前缀模式下生效，取值不合法会导致组帧配置校验失败并返回 -1
帧分隔符	`frameDelimiter`	string	\r\n	否	delimiter 模式下用于切分帧的字节序列，默认回车换行，可填写多字节分隔符；解帧时分隔符会被自动剔除，仅该模式生效，raw 与 length-prefix 模式忽略此参数

输出参数 6

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	本次操作的返回码，0=启动、停止或成功收包并解帧完成，-1=端口非法、绑定失败、组帧参数错误、接收超时或报文不满足组帧要求，此时运行信息写明具体原因
运行信息	`resultInfo`	string	—	否	本次执行的状态描述，成功时写明服务器已启动、已停止或已接收的字节数，失败时给出具体原因，如端口缺失或非法、绑定失败、接收超时、帧超限或报文未包含完整帧，便于定位失败环节
监听中	`active`	bool	—	否	指示 UDP socket 是否已绑定端口处于监听状态，start 成功后为 true，stop 后为 false；绑定通信配置走常驻模式时该输出恒为 true，recv 自动启动服务器成功时也会置为 true
最近数据	`last_data`	string	—	否	recv 最近一次收到的数据报内容，raw 模式下为整个报文本身，delimiter 或 length-prefix 模式下为解出的首帧载荷且已剔除分隔符或长度字段；仅在成功接收时更新，帧数输出与之对应
最近发送方	`last_sender`	string	—	否	recv 最近一次数据报的来源地址，以 IP 加冒号加端口的形式给出；仅在成功接收时更新，可据此区分不同客户端，绑定通信配置走常驻模式时同样按实际来源地址填写
帧数	`frame_count`	int	—	否	recv 收取的报文在非 raw 模式下解出的完整帧数量，delimiter 与 length-prefix 模式成功解帧时才有该输出，数值等于本次解析得到的帧数；raw 模式不产生帧计数，该输出不更新

接入方式

在 FlowDesigner 中将「UDP服务端」节点加入流程画布，把上游图像或数据连接至「通信配置ID」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← UDP客户端返回通信 HTTP客户端 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈