# UDPSocket

基础库 2.7.0 开始支持，低版本需做兼容处理。

相关文档: 网络使用说明、局域网通信

一个 UDP Socket 实例，默认使用 IPv4 协议。

# 方法

# number UDPSocket.bind(number port)

绑定一个系统随机分配的可用端口，或绑定一个指定的端口号

# UDPSocket.setTTL(number ttl)

设置 IP_TTL 套接字选项，用于设置一个 IP 数据包传输时允许的最大跳步数

# UDPSocket.send(Object object)

向指定的 IP 和 port 发送消息。基础库 2.9.0 起支持广播 (指定地址为 255.255.255.255)。

# UDPSocket.connect(Object object)

预先连接到指定的 IP 和 port，需要配合 write 方法一起使用

# UDPSocket.write(Object object)

用法与 send 方法相同，如果没有预先调用 connect 则与 send 无差异（注意即使调用了 connect 也需要在本接口填入地址和端口参数）

# UDPSocket.close()

关闭 UDP Socket 实例，相当于销毁。 在关闭之后，UDP Socket 实例不能再发送消息，每次调用 UDPSocket.send 将会触发错误事件，并且 message 事件回调函数也不会再也执行。在 UDPSocket 实例被创建后将被 Native 强引用，保证其不被 GC。在 UDPSocket.close 后将解除对其的强引用，让 UDPSocket 实例遵从 GC。

# UDPSocket.onClose(function listener)

监听关闭事件

# UDPSocket.offClose(function listener)

移除关闭事件的监听函数

# UDPSocket.onError(function listener)

监听错误事件

# UDPSocket.offError(function listener)

移除错误事件的监听函数

# UDPSocket.onListening(function listener)

监听开始监听数据包消息的事件

# UDPSocket.offListening(function listener)

移除开始监听数据包消息的事件的监听函数

# UDPSocket.onMessage(function listener)

监听收到消息的事件

# UDPSocket.offMessage(function listener)

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

# 错误