Version: next
UDPSocket
一个 UDP Socket 实例，默认使用 IPv4 协议。
方法
close
关闭 UDP Socket 实例，相当于销毁。 在关闭之后，UDP Socket 实例不能再发送消息，每次调用 UDPSocket.send 将会触发错误事件，并且 message 事件回调函数也不会再也执行。在 UDPSocket 实例被创建后将被 Native 强引用，保证其不被 GC。在 UDPSocket.close 后将解除对其的强引用，让 UDPSocket 实例遵从 GC。
() => void
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.close | ✔️ |
offClose
取消监听关闭事件
(callback: OffCloseCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OffCloseCallback | 关闭事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.offClose | ✔️ |
offError
取消监听错误事件
(callback: OffErrorCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OffErrorCallback | 错误事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.offError | ✔️ |
offListening
取消监听开始监听数据包消息的事件
(callback: (res: CallbackResult) => void) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | (res: CallbackResult) => void | 开始监听数据包消息的事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.offListening | ✔️ |
offMessage
取消监听收到消息的事件
(callback: (res: CallbackResult) => void) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | (res: CallbackResult) => void | 收到消息的事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.offMessage | ✔️ |
onClose
监听关闭事件
(callback: OnCloseCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnCloseCallback | 关闭事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.onClose | ✔️ |
onError
监听错误事件
(callback: OnErrorCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnErrorCallback | 错误事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.onError | ✔️ |
onListening
监听开始监听数据包消息的事件
(callback: (res: CallbackResult) => void) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | (res: CallbackResult) => void | 开始监听数据包消息的事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.onListening | ✔️ |
onMessage
监听收到消息的事件
(callback: OnMessageCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnMessageCallback | 收到消息的事件的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.onMessage | ✔️ |
send
向指定的 IP 和 port 发送消息
(option: SendOption) => void
| 参数 | 类型 |
|---|---|
| option | SendOption |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.send | ✔️ |
bind
绑定一个系统随机分配的可用端口，或绑定一个指定的端口号
(port: number) => number
| 参数 | 类型 | 说明 |
|---|---|---|
| port | number | 指定要绑定的端口号 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.bind | ✔️ |
参数
OffCloseCallback
关闭事件的回调函数
(res: CallbackResult) => void
| 参数 | 类型 |
|---|---|
| res | CallbackResult |
OffErrorCallback
错误事件的回调函数
(res: CallbackResult) => void
| 参数 | 类型 |
|---|---|
| res | CallbackResult |
OnCloseCallback
关闭事件的回调函数
(res: CallbackResult) => void
| 参数 | 类型 |
|---|---|
| res | CallbackResult |
OnErrorCallback
错误事件的回调函数
(result: OnErrorCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnErrorCallbackResult |
OnMessageCallback
收到消息的事件的回调函数
(result: OnMessageCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnMessageCallbackResult |
OnErrorCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| errMsg | string | 错误信息 |
OnMessageCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| message | ArrayBuffer | 收到的消息 |
| remoteInfo | RemoteInfo | 消息来源的结构化信息 |
RemoteInfo
消息来源的结构化信息
| 参数 | 类型 | 说明 |
|---|---|---|
| address | string | 发送消息的 socket 的地址 |
| family | string | 使用的协议族，为 IPv4 或者 IPv6 |
| port | number | 端口号 |
| size | number | message 的大小，单位：字节 |
SendOption
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | string | ArrayBuffer | 是 | 需要发送的内容 |
| complete | (res: CallbackResult) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| fail | (res: CallbackResult) => void | 否 | 接口调用失败的回调函数 |
| success | (res: CallbackResult) => void | 否 | 接口调用成功的回调函数 |
API 支持度
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| UDPSocket.close | ✔️ | ||
| UDPSocket.offClose | ✔️ | ||
| UDPSocket.offError | ✔️ | ||
| UDPSocket.offListening | ✔️ | ||
| UDPSocket.offMessage | ✔️ | ||
| UDPSocket.onClose | ✔️ | ||
| UDPSocket.onError | ✔️ | ||
| UDPSocket.onListening | ✔️ | ||
| UDPSocket.onMessage | ✔️ | ||
| UDPSocket.send | ✔️ | ||
| UDPSocket.bind | ✔️ |