webSocket

来自于:开发者立即使用

概述

WebSocket简介

WebSocket用于在Web浏览器和服务器之间进行任意的双向数据传输的一种技术。WebSocket协议基于TCP协议实现,包含初始的握手过程,以及后续的多次数据帧双向传输过程。其目的是在WebSocket应用和WebSocket服务器进行频繁双向通信时,可以使服务器避免打开多个HTTP连接进行工作来节约资源,提高了工作效率和资源利用率。

webSocket 模块概述

本模块封装了的原生WebSocket通信,支持ws、wss协议。

使用此模块之前建议先配置config.xml文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:webSocket
  • 参数:isGlobal
  • 配置示例:
  <feature name="webSocket">
    <param name="isGlobal" value="true"/>
  </feature>
  • 字段描述:
**isGlobal**:(必须配置)模块对象是否全局变量控制,当设置true时整个app只生成一个对象,可以跨页面进行发送数据;当设置为fasle时每一个页面初始化一次就是一个对象,页面间的对象不能互相操作。

模块接口

addEventListener

websocket消息监听,可以监听连接,断开,接收消息等事件。

addEventListener(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true,      //布尔型;true||false
    evenType : 'Connected',      //字符串: 消息类型事件
                                    //Connected 连接成功
                                    //ReturnData 接收消息
                                    //Closed 连接断开
   data : ''    //接收消息内容,仅evenType='ReturnData'有效
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1,
    msg : ''
}

示例代码

var demo = api.require('webSocket');
demo.addEventListener(function(ret, err) {
    alert(JSON.stringify(ret) + "  " + JSON.stringify(err));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

open

连接websocket

open({params}, callback(ret, err))

params

url:

  • 类型:字符串
  • 描述:(必填项)websocket的连接地址:如:ws://192.168.1.102:8887/socket。

callback(ret, err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1 ,
    msg : ''
}

示例代码

var demo = api.require('webSocket');
demo.open({
    url : 'ws://192.168.1.102:8887/socket'
}, function(ret, err) {
    alert(JSON.stringify(ret) + "  " + JSON.stringify(err));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

send

发送内容

send({params}, callback(ret, err))

params

data:

  • 类型:字符串
  • 描述:(必填项)发送的消息内容。

callback(ret, err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1,
    msg : ''
}

示例代码

var demo = api.require('webSocket');
demo.send({
    data : '我是消息内容'
}, function(ret, err) {
    alert(JSON.stringify(ret) + "  " + JSON.stringify(err));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭连接

close(callback(ret, err))

callback(ret, err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1,
    msg : ''
}

示例代码

var demo = api.require('webSocket');
demo.close(unction(ret, err) {
    alert(JSON.stringify(ret) + "  " + JSON.stringify(err));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本