UDPSocket

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

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

方法

number UDPSocket.bind(number port)

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

UDPSocket.send(Object object)

向指定的 IP 和 port 发送消息

UDPSocket.close()

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

UDPSocket.onClose(function callback)

监听关闭事件

UDPSocket.offClose(function callback)

取消监听关闭事件

UDPSocket.onError(function callback)

监听错误事件

UDPSocket.offError(function callback)

取消监听错误事件

UDPSocket.onListening(function callback)

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

UDPSocket.offListening(function callback)

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

UDPSocket.onMessage(function callback)

监听收到消息的事件

UDPSocket.offMessage(function callback)

取消监听收到消息的事件

错误

错误码 错误信息 说明
-1 系统错误
-2 socket接口错误
-3 发送失败,无接口权限
1 发送失败,参数错误,address不合法
2 发送失败,参数错误,port不合法