更新记录

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同时连接通信

平台兼容性

原生插件通用使用流程：

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
});