更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

• 首个版本，功能可用

平台兼容性

pk-socket-pro TCP/UDP 双协议通信套件

TCP/UDP 双协议通信：粘包拆包（长度前缀 / 分隔符 / 定长）、心跳保活、指数退避重连、UDP 广播与 seq 应答匹配、连接状态机与关闭原因归一。

双层架构：JS 协议层（拆包 / 心跳 / 重连 / 应答，可在 Node 单测）＋ 原生薄壳（Kotlin / Swift，只做 fd 收发与回调）。竞品痛点「安卓连上就断」「UDP 广播发得出收不回」「粘包没人管」全部在协议层根治。

5 分钟接入

import sk from '@/uni_modules/pk-socket-pro/js_sdk/index.js'
// 接原生通道（自定义基座里已集成了 PKSocketPro 原生模块）
const conn = sk.open({
  protocol: 'tcp', host: '127.0.0.1', port: 9123,
  framing: { strategy: 'length_prefix', opts: { lengthBytes: 4 } },
  heartbeat: { data: 'ping', interval: 15000, deadFactor: 2.5 },
  reconnect: { base: 1000, max: 30000, maxRetries: 10 }
})
conn.on('open', () => console.log('已连接'))
conn.on('message', (m) => console.log('收到', m.text))   // m.bytes 为原始 Uint8Array
conn.write('hello')
conn.close()

UTS 通道接入（推荐，跨端一致）：

import sk from '@/uni_modules/pk-socket-pro/js_sdk/index.js'
import { createSocket } from '@/uni_modules/pk-socket-pro/utssdk/index.uts'
sk.open({ protocol: 'tcp', host, port, framing: { strategy: 'delimiter', opts: { delimiter: '\n' } },
  _socketFactory: createSocket })

API 全表

拆包策略

关闭原因（决定要不要自动重连）

close 事件携带归一后的 { reason, retry }：

错误码

真机验收清单（需你配合）

• [ ] 真机 TCP 连接后杀掉服务端 → reconnecting 事件触发，退避后重连成功
• [ ] 切 4G↔WiFi → fd_invalid 触发重连，业务无感
• [ ] UDP 广播：设备 A 广播，设备 B 收到并 request 拿到 ack
• [ ] 高频率粘包（一次 recv 多帧）→ 逐条 message 正确拆分
• [ ] 弱网半包（一次 recv 不足一帧）→ 缓冲至下个包补齐

体积说明

不内置任何第三方 so / SDK，原生壳纯 Kotlin / Swift 实现，UTS 通道零额外依赖，云打包不受影响。