更新记录

1.0.9（2022-03-23）

1.修复UDP广播监听断开广播后无法绑定新端口的bug

1.0.8（2021-12-09）

1.新增localPort,解决发送广播无法设置本地端口的问题

1.0.7（2020-11-03）

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

平台兼容性

原生插件通用使用流程：

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.一次初始化,全局调用的方案,请"下载示例项目ZIP"

集成插件说明

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

引用插件

const UDPSocket = uni.requireNativePlugin('Aimer-UDPPlugin');

一. UDP 单播流程

1. UDP 初始化连接 IP和Port

UDPSocket.connect(
                {
                    //charsetname:'GBK',//可不选,默认UTF-8,针对服务端数据的字符集格式转化
                    ip: '192.168.31.97',
                    port: '6666'
                },
                result => {
                    /**
                     * status : 0 连接成功
                     * status : 1 断开连接
                     * receivedMsg : 服务器返回信息
                     * receivedHexMsg : 服务器返回字节数组(单片机、智能家居等硬件数据交互)
                     */
                    if (result.status == '0') {
                        //UDP连接成功
                        console.log('UDP连接成功');
                    } else if (result.status == '1') {
                        //UDP断开连接
                        console.log('UDP断开连接');
                    }
                    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. UDP 发送字符串消息(普通的字符串交互)

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

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

举例:发送开门指令
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}

UDPSocket.sendBytes({
                bytesMessage: JSON.stringify(openDoor) //对指令进行json转换
            });

4. UDP 断开连接

UDPSocket.disconnect();

二. UDP 广播流程

1. UDP 绑定端口接收广播

UDPSocket.bindBroadcast(
                {
                    //charsetname:'GBK',//可不选,默认UTF-8
                    port: '7777'
                },
                result => {
                    /**
                     * status : 0 开启广播接收
                     * status : 1 关闭广播接收
                     * recBroadMsg : 服务器返回信息 
                     * recBroadHexMsg :服务器返回字节数组(单片机、智能家居等硬件数据交互)
                     * recBroadAddress :发送端IP地址
                     */
                    if (result.status == '0') {
                        //UDP连接成功
                        console.log('UDP开启广播接收');
                    } else if (result.status == '1') {
                        //UDP断开连接
                        console.log('UDP关闭广播接收');
                    }
                    if (result.recBroadMsg) {
                        //服务器返回信息
                        console.log(result.recBroadMsg);
                        console.log(result.recBroadAddress);
                    }
                    if (result.recBroadHexMsg) {
                        //Hex服务器返回信息
                        console.log(result.recBroadHexMsg);
                        console.log(result.recBroadAddress);
                        let msg = result.recBroadHexMsg;
                        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. UDP 发送字符串广播消息(普通的字符串交互)

UDPSocket.sendBroadcast({
                //charsetname:'GBK',//可不选,默认UTF-8
                ip: '192.168.31.255',//255表示该节点0~255均可以获取广播
                port: '7777',//目标端口
                localPort:'9527',//本地端口
                message: '发送内容'
            });

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

举例:发送开门指令
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}

UDPSocket.sendBytesBroadcast({
                ip: '192.168.31.255',//255表示该节点0~255均可以获取广播
                port: '7777',//目标端口
                localPort:'9527',//本地端口
                bytesMessage: JSON.stringify(openDoor) //对指令进行json转换
            });

4. UDP 断开广播接收

UDPSocket.closeBroadcast();