更新记录

1.0.3（2026-04-02）

修复ios发送数据卡住的问题

1.0.2（2026-03-05）

支持ios

1.0.1（2026-02-26）

优化

平台兼容性

uni-app(4.62)

uni-app x(4.62)

umini-socket

一个基于 UTS 开发的 TCP 通讯插件，支持在 uni-app 和 uni-app-x 中进行 TCP 网络通信。

功能特性

• TCP 客户端连接管理
• 支持字符串和十六进制数据发送
• 完整的事件监听机制（连接、断开、接收数据、错误）
• 异步连接和数据发送
• 进程级别的网络管理

安装

将 umini-socket 目录放入项目的 uni_modules 目录下。

快速开始

1. 导入模块

import * as UminiSocket from '@/uni_modules/umini-socket'

2. 初始化模块

// 需在应用首屏调用，注意：是应用启动的第一屏
UminiSocket.initial()

3. 设置事件监听器

UminiSocket.setTcpListener({
  onConnected: () => {
    console.log('TCP 连接成功')
  },
  onDisconnected: () => {
    console.log('TCP 连接断开')
  },
  onReceived: (data) => {
    console.log('收到数据:', data.data)
  },
  onError: (message) => {
    console.log('TCP 错误:', message)
  }
})

4. 连接服务器

// 连接到服务器
UminiSocket.connect('192.168.1.100', 8080)

// 带超时时间的连接（默认 5000ms）
UminiSocket.connect('192.168.1.100', 8080, 10000)

5. 发送数据

// 发送字符串
UminiSocket.sendString('Hello, Server!')

// 发送十六进制数据
UminiSocket.sendHex('01 02 03 FF')

6. 断开连接

UminiSocket.disconnect()

API 文档

initial()

初始化 TCP 模块，启动网络监听。

UminiSocket.initial()

说明: 建议在应用启动时调用一次即可。

setTcpListener(listener)

设置 TCP 事件监听器。

UminiSocket.setTcpListener(listener: TCPListener)

参数:

TCPListener 类型定义:

type TCPListener = {
  onConnected?: () => void,      // 连接成功回调
  onDisconnected?: () => void,   // 连接断开回调
  onReceived?: (data: UTSJSONObject) => void,  // 数据接收回调
  onError?: (message: String) => void          // 错误回调
}

connect(host, port, timeout?)

连接到 TCP 服务器。

UminiSocket.connect(host: String, port: number, timeout?: number)

参数:

disconnect()

断开 TCP 连接。

UminiSocket.disconnect()

sendString(data)

发送字符串数据。

UminiSocket.sendString(data: string)

参数:

sendHex(data)

发送十六进制数据。

UminiSocket.sendHex(data: string)

参数: