通信
UDP客户端
按 send 或 recv 操作经 UDP 收发数据报，可绑定本地端口，支持长度前缀、分隔符与原始三种组帧模式，输出发送字节数、接收内容、来源地址与状态UdpClientTool · v1.0 · by system
输入参数 10
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 通信配置ID | commId | enum | （空） | 否 | 通信配置标识，非空时按该标识复用通信中心已建立的常驻 UDP 套接字，不再重复创建或绑定，但目标地址与端口仍须合法；留空则按手动填写的地址参数自行建套接字，并在本地端口大于 0 时绑定该端口 |
| 目标IP | remoteHost | string | 127.0.0.1 | 否 | 数据报发往的目标 IPv4 地址，默认 127.0.0.1；该值为空或不是可识别的 IPv4 地址时返回 -1 并在运行信息写明原因，通信配置标识非空时同样要求该值合法 |
| 目标端口 | remotePort | int | 9001 | 否 | 目标主机的 UDP 端口，默认 9001，有效范围 1~65535；取值小于等于 0 或大于 65535 时返回 -1 并在运行信息提示参数错误 |
| 本地端口 | localPort | int | 0 | 否 | 本端绑定的 UDP 端口，默认 0 表示不主动绑定而由系统分配；仅在未使用通信配置标识时生效，取值大于 0 时绑定到本机所有网卡的该端口，绑定失败返回 -1 并给出系统错误码 |
| 操作 | operation | enum | send | 否 | 本次执行的操作，默认 send；send 把发送数据封装成数据报发往目标，recv 在超时时间内等待并读取一个报文；取其他值会返回 -1 并在运行信息提示未知操作 |
| 发送数据 | data | string | （空） | 否 | send 操作要发送的文本内容，默认空串；内容为空时直接跳过发送并返回成功、发送字节数为 0；非空时按组帧模式编码后经 sendto 发出，编码或发送失败返回 -1 |
| 超时(ms) | timeoutMs | int | 3000 | 否 | recv 操作等待报文的超时，单位毫秒，默认 3000；取值不大于 0 时按 3000 处理，超时或接收出错时返回 -1 并在运行信息提示接收超时或具体错误码 |
| 组帧模式 | frameMode | enum | raw | 否 | 数据报的组帧方式，默认 raw 即不组帧；可选 length-prefix 长度前缀帧、delimiter 分隔符帧与 raw 原始报文；取值无法识别或相应参数不合法时返回 -1 并在运行信息提示组帧参数错误 |
| 长度字段字节数 | lengthFieldBytes | int | 4 | 否 | 仅 length-prefix 组帧模式生效，指定长度字段占用的字节数，默认 4，支持 1、2、4、8；该值不合法会使组帧配置校验失败并返回 -1，其他模式下被忽略 |
| 帧分隔符 | frameDelimiter | string | \r\n | 否 | 仅 delimiter 组帧模式生效，作为帧的分隔字符串，默认回车换行且可含多个字节；接收解码时会自动剔除该分隔符，raw 与 length-prefix 模式下此值不参与处理 |
输出参数 7
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=本次发送或接收操作成功完成；-1=参数非法、套接字或绑定失败、组帧配置不合法、发送接收出错、报文未含完整帧或操作名未知，运行信息写明具体原因 |
| 运行信息 | resultInfo | string | — | 否 | 本次执行的状态文字，成功时给出已发送或已接收的字节数，空数据发送时提示已跳过；失败时给出参数错误、无效地址、绑定或发送失败、接收超时、组帧与协议错误或未知操作等具体原因 |
| 发送字节 | sent_bytes | int | — | 否 | send 操作实际发出的字节数，按组帧编码后的报文长度统计；发送数据为空时固定为 0，发送失败时该输出不写出，recv 操作不产生该值 |
| 接收数据 | received | string | — | 否 | recv 操作收到的数据内容，默认按整份报文原样给出；采用非 raw 组帧模式时改为解码后首个完整帧的载荷，报文无完整帧或协议错误时不会输出该值 |
| 发送方IP | sender_ip | string | — | 否 | recv 操作收到报文的来源 IPv4 地址，以点分十进制文本给出；仅在成功接收时写出，地址转换失败时为空字符串，send 操作不产生该值 |
| 发送方端口 | sender_port | int | — | 否 | recv 操作收到报文的来源端口号，按网络字节序转换后以整数给出；仅在成功接收时写出，send 操作不产生该值 |
| 帧数 | frame_count | int | — | 否 | recv 操作从单个报文解码得到的完整帧数量，仅在 length-prefix 或 delimiter 组帧模式下写出；raw 模式、发送操作以及解码失败时不输出该值 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈