myWebSocket

来自于:开发者立即使用

概述

WebSocket 本模块封装了 安卓与ios websocket原生SDK 基础功能

模块概述

  • 发送消息
  • 支持自定义心跳数据

不能同时使用的模块:webSocket

服务端推荐使用 ,均支持百万级别

  • java t-io 是基于jdk aio实现的易学易用、稳定耐操、性能强悍、将多线程玩的极致 的即时通讯框架
  • php swoole 、 workerman

模块接口

open

打开连接
是否连接成功,请以事件监听(bindEvent) 状态为准

open(params,callback(ret, err))

params

url:

  • 类型:字符串
  • 描述:服务端地址

pingInterval:

  • 类型:整型
  • 描述:(可选项)心跳间隔,单位秒,设置大于0时起效果
  • 默认值:0
  • 取值范围:
    • > 0 等整型

pingData:

  • 类型:字符串
  • 描述:(可选项)心跳数据,配合pingInterval 使用
  • 默认值:ping

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true      //打开成功
    data: "打开成功" // 
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    status: false     //打开失败;
    data:"提示信息"      
}

示例代码

var myWebSocket = api.require('myWebSocket');
myWebSocket.open({
    url:'ws://host:port',
    pingInterval:30,
    pingData:'ping'
},function(ret, err) {
    if (ret) {
        alert("打开成功");
    } else {
        alert('打开失败');
    }
});

bindEvent

事件监听

bindEvent(callback(ret,err))

callback(ret,err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    type:""      // opened 打开成功,连接上了服务器
                 // closed 连接已关闭
                 // receive 接收到了消息
                 //
    data: ""    //字符串; 
}

示例代码

var myWebSocket = api.require('myWebSocket');
myWebSocket.bindEvent( function(ret,err) {
       var type = ret.type;
       var str =ret.data;

       switch (type){
           case 'opened':
                //登录...
                var data = {type: 'login', 'uid': 1, 'froms': 'app'};
                webSocket.send({msg:JSON.stringify(data)})

                break;
           case 'receive':
               var message = JSON.parse(str);
               //do something ...
                break;
           case 'closed':
               //do something ...
                alert("连接已断开");
                //打印关闭的log
                console.log(str)
                break;
       }  
});

send

发送消息

send({params})

params

msg:

  • 类型:字符串
  • 描述:发送内容

返回值

  • success 发送成功
  • fail 发送失败

示例代码

var myWebSocket = api.require('myWebSocket');
var result = myWebSocket.send({msg:"hello"});
// result 值为 success 或 fail

close

关闭连接

close(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true   //布尔型;true||false
    data:"" 
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    status: false     
    data:""
}

可用性

iOS系统,Android系统