更新记录

1.0.7(2020-11-03)

1.解决和部分插件依赖冲突的问题

1.0.6(2020-09-07)

1.针对中文字符串的发送和接受,新增"GBK"字符集格式,默认格式为"UTF-8"

1.0.5(2020-08-05)

1.支持最多20路TCP同时连接通信

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 14.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 适用版本区间:9 - 17

原生插件通用使用流程:

  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.支持最多20路TCP同时连接,请注意TCP连接、发消息、断连的channel值要保持一致;
3.一次初始化,全局调用的方案,请"下载示例项目ZIP"

集成插件说明

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

引用插件

const TCPSocket = uni.requireNativePlugin('Aimer-TCPPlugin');

1. TCP 初始化连接 IP和Port

TCPSocket.connect(
                {
                    //charsetname:'GBK',//可不选,默认UTF-8,针对服务端数据的字符集格式转化
                    channel:'1',//可选 1~20
                    ip: '192.168.31.97',
                    port: '6666'
                },
                result => {
                    /**
                     * status : 0 连接成功
                     * status : 1 断开连接
                     * receivedMsg : 服务器返回字符串(普通的字符串交互)
                     * receivedHexMsg : 服务器返回字节数组(单片机、智能家居等硬件数据交互)
                     */
                    if (result.status == '0') {
                        //TCP连接成功
                        console.log('TCP连接成功');
                    } else if (result.status == '1') {
                        //TCP断开连接
                        console.log('TCP断开连接');
                    }
                    if (result.receivedMsg) {
                        //服务器返回字符串
                        console.log(result.receivedMsg);
                    }
                    if (result.receivedHexMsg) {
                        //硬件服务器返回16进制数据
                        console.log(result.receivedHexMsg);
                        let msg=result.receivedHexMsg;
                        let sum = msg.length / 2;
                        let arr = [];
                        for (let k = 0; k < sum; k++) {
                            let i = msg.substring(k * 2, k * 2 + 2);
                            arr.push(i);
                        }
                        console.log(arr);
                    }
                }
            );

2. TCP 发送消息(普通的字符串交互)

TCPSocket.send({
                //charsetname:'GBK',//可不选,默认UTF-8
                channel:'1',//可选 1~20
                message: '发送内容'
            });

3. TCP 发送字节数组(发送控制单片机、智能家具等硬件的指令)

举例:发送开门指令
let openDoor=['53', '53', '01', 'c0', '00', 'A9', '09', '10', '11', '12', '19', '20', 'ff', 'ff', '4E', '4E'],//不限制字母大小写
等效于
byte[] openDoorJava={0x53,0x53,0x01,0xc0,0x00,0xA9,0x09,0x10,0x11,0x12,0x19,0x20,0xff,0xff,0x4E,0x4E}

TCPSocket.sendBytes({
                channel:'1',//可选 1~20
                bytesMessage: JSON.stringify(openDoor) //对指令进行json转换
            });

4. TCP 断开连接

TCPSocket.disconnect({ 
            channel: '1'//可选 1~20
});

隐私、权限声明

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

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

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

插件不采集任何数据

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

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