更新记录

1.0.7(2021-11-25)

1、增加发送btye数据; 2、优化iOS 断线重连功能; 3、增加了发送消息状态回调;

1.0.6(2021-10-11)

1、优化了心跳检测; 2、增加了字节流数据的接收; 3、提供了node.js 服务端参考demo

1.0.5(2021-04-28)

1、修复android 闪退

查看更多

平台兼容性

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

原生插件通用使用流程:

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


集成原生WebSocket

更新提示:1、增加了发送消息回调状态;

​ 2、增加了发送btye数据;

​ 3、优化了ios断线重连功能;

​ 特点:

​ 1、断线重连功能;

​ 2、心跳检测功能;

​ 3、支持接受字符串和字节流数据;

​ 4、可发送字节流数据

插件使用介绍;

​ 先引入插件: let WebSocketTool=uni.requireNativePlugin("CL-WebSocket");

​ 1、初始化

          WebSocketTool.initWS({
                        url:"ws://192.168.50.215:7272",//ws服务器地址
                        pingInterval:5//心跳频率单位s
                });



​ 2、连接服务器;

        //进行服务器连接;
        //连接操作,除非用户主动断开,否则不需要再次调用这个接口,因为内部集成了断开重连功能;
            WebSocketTool.connect(result=>{
                console.log(result);    
                let type=result.type;
                if(type=='onOpen')
                {
            uni.showToast({
              title:"已连接成功"
            })

                }
                else if(type=='onReconnect')
                {
            uni.showToast({
              title:"重新连接中"
            })

                }
                else if(type=='onClosed')
                {

            uni.showToast({
              title:"服务器已断开"
            })

                }
                else if(type=='onFailure')
                {
                    uni.showToast({
                        title:"连接失败,请等待重连"
                    })

                }
            });

3、监听服务器发送的消息;

    //监听字符串数据
  WebSocketTool.onSocketMessage(result=>{

            console.log("收到消息:"+result);

    })  


//监听流数据 WebSocketTool.onSocketByte(result=>{

                //数据做了base64处理;
                console.log("收到btye数据:"+result);
                this.msgAr.push("收到btye数据:"+result)

            });

4、获取连接状态;

    getConnectState: async function(){
     //1表示已连接, -1表示未连接,  0表示正在连接中;
      let state=await WebSocketTool.getCurrentStatus();
           uni.showModal({
            content:"当前状态:"+state
           })

    }

5、发送消息;

    sendMsg: async function(){
            //需要判断一下是否连接
            let state=await WebSocketTool.getCurrentStatus();
            if(state==1)
            {   

                WebSocketTool.sendMessage({"code":120,msg:"zxcioqnocdqiw",token:"sasasas"},result=>{

                        //发送状态回调;

                });

            }
            else{

                uni.showModal({
                    content:"未连接服务器"
                })

            }
}

6、发送byte 数据

sendMsg: async function(){
        //需要判断一下是否连接
        let state=await WebSocketTool.getCurrentStatus();
        if(state==1)
        {   

            let msg="hello 你好 你好";
                let baseStr=Buffer.from(msg).toString("base64");
              //需转成base64
       WebSocketTool.sendByteString(baseStr,result=>{

                    //发送状态回调;

                });

        }
        else{

            uni.showModal({
                content:"未连接服务器"
            })

        }
}

7、主动断开连接;(执行该方法之后,需要调用连接接口才能进行连接服务器)

WebSocketTool.closeWS();

服务端demo node.js 参考;更多详情可以参考 https://blog.csdn.net/LiMubai_CN/article/details/81844156 了解如何使用ws

`

 const WebSocketServer=require("ws");

const wss = new WebSocketServer.Server({ port: 7272 });


wss.on('connection', function connection(ws) { ws.on('message', function incoming(message) { console.log('received: %s', message); ws.send('something'+message); });

  ws.send('something');
  ws.on("pong",function(data){

     console.log('收到心跳啦啦啦'+data);

  })
  ws.on("ping",function(data){

    console.log('收到心跳啦啦啦'+data);
        ws.send("asasa",{binary:true}); //发送的是字节流数据

  })
  // 退出 
  ws.on('close', function(close) {  
      console.log('退出连接了');
      ws.send('退出连接');
  });  
  ws.on('error', function(error) {
      console.log('错误信息'+error);

  }); 
 });


console.log('开始监听7272端口');

`

隐私、权限声明

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

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

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

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