# UDPSocket.onMessage(function listener)

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.11.1](1003706)
> 
> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [网络使用说明](/miniprogram/dev/framework/ability/network.md)、[局域网通信](/miniprogram/dev/framework/ability/mDNS.md)

## 功能描述

监听收到消息的事件

## 参数

### function listener

收到消息的事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "message",
    "类型": "ArrayBuffer",
    "说明": "收到的消息。消息长度需要小于4096。"
  },
  {
    "属性": "remoteInfo",
    "类型": "Object",
    "说明": "发送端地址信息",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "发送消息的 socket 的地址"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号"
      },
      {
        "结构属性": "size",
        "类型": "number",
        "说明": "message 的大小，单位：字节"
      }
    ]
  },
  {
    "属性": "localInfo",
    "类型": "Object",
    "说明": "接收端地址信息，2.18.0 起支持",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "接收消息的 socket 的地址"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号"
      }
    ]
  }
]
```