更新记录

1.1.2（2024-04-19）

1. 修复服务端异常断开后，导致监听消息一直返回空信息
2. 监听消息增加断开状态码：-1

1.1.1（2024-04-10）

1. 修复发送普通文本消息不支持中文问题

1.1.0（2024-04-01）

1. 支持设置超时时间
2. 支持连接状态查询
3. 监听消息增加对GBK、HEX的字符支持
4. 调整发送消息格式
5. 优化错误消息提示

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

引入插件

const TCPSocket = uni.requireNativePlugin("TCP-Socket");

连接

创建TCP连接

TCPSocket.connect({
    host: '192.168.1.1',
    port: 8888
}, res => {
    uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});

参数说明

响应参数说明

连接状态

获取TCP连接状态

TCPSocket.isConnected(status => {
    uni.showToast({ title: '响应数据：' + status, icon: 'none' });
});

响应参数说明

断开连接

断开TCP连接

TCPSocket.disconnect(res => {
    uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});

响应参数说明

监听消息

监听服务端响应消息

TCPSocket.message({
    // 如果不设置参数，此处必须保留空对象
    charsetName: 'GBK'
}, res => {
    uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});

参数说明

响应参数说明

发送文本

向服务端发送普通文本消息

TCPSocket.send('abcd123', res => {
    uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});

响应参数说明

发送Hex

向服务端发送16进制消息

TCPSocket.sendHex(['0C', '62', '06', '0A', 'D7', '3C'], res => {
    uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});

响应参数说明