更新记录

1.0.0(2022-04-02)

TCPSocket for Android


平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


插件特点

  1. 插件使用异步收发消息,避免了线程阻塞问题;
  2. 支持多路TCP同时连接,请注意TCP连接、发消息、断连的flag值要保持一致;
  3. 支持发送5种格式消息(Hex十六进制字符串、UTF8字符串、GBK字符串、ASCii字符串和普通字符串);

集成插件说明

https://nativesupport.dcloud.net.cn/NativePlugin/use/use

插件使用说明

引用插件

const TCPSocketUtil = uni.requireNativePlugin("LGR-TCPSocketUtil")

TCP连接

TCPSocketUtil.connect({
                        flag: '1',//socket的标志,用来区分各个socket
                        ip: '10.14.3.104',
                        port: 8001
                    },
                    (ret) => {
                        var res = ret.status;
                        if (res == 0) {
                            console.log('连接关闭')
                        } else if (res == 1) {
                            console.log('连接成功')
                        } else if (res == 2) {
                            console.log('连接错误')
                        } else if (res == 3) {
                            console.log('连接超时')
                        } else if (res == 4) {
                            console.log('获取数据(Hex形式))')
                            console.log(ret.data)
                        } else if (res == 5) {
                            console.log('获取数据(Bytes[]形式)')
                            console.log(ret.data)
                        }
                    })

TCP发送消息

//Hex               
TCPSocketUtil.sendHex({
                    flag: '1',
                    msg: '4E54303153030101FA'
                });
//UTF8
TCPSocketUtil.sendUTF8({
                    flag: '1',
                    msg: '4E54303153030101FA'
                });
//GBK
TCPSocketUtil.sendGBK({
                    flag: '1',
                    msg: '4E54303153030101FA'
                });
//Ascii
TCPSocketUtil.sendAscii({
                    flag: '1',
                    msg: '4E54303153030101FA'
                });
//普通字符串
TCPSocketUtil.send({
                    flag: '1',
                    msg: '4E54303153030101FA'
                });

TCP断开连接

TCPSocketUtil.disconnect({
                    flag: '1'
                });

隐私、权限声明

1. 本插件需要申请的系统权限列表:

网络连接权限 <uses-permission android:name="android.permission.INTERNET"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问