ios-plugin-mqtt

为解决前端使用cordova框架开发ios移动应用中使用到的mqtt通讯协议，而自定义扩展的cordova插件。

Thanks for 'MQTT-Client-Framework' library files from Mr ckrey.
https://github.com/ckrey/MQTT-Client-Framework 本Cordova插件是基于Mr ckrey的mqtt库构建的。

安装插件（环境：安装nodejs引擎并安装cordova插件）

cordova plugin add ios-plugin-mqtt

插件使用接口说明：

1. 建立mqtt连接

接口：connect(options)
参数：options
参数说明：
options={
  username:“用户名”
  password:“密码”
  clientId:“编号”
  keepAlive:“保持连接的时间周期，单位：秒数”
  url:“连接地址 例如：tcp://127.0.0.1”
  port:"端口号"
}

//案例
cordova.plugins.CordovaMqTTPlugin.connect({
	url:"tcp://127.0.0.1", 
	port:3000,
	clientId:"1002010",
	username:"admin",
	password:"123",
	keepAlive:86400,
	success:function(s){//连接成功回调
	},
	error:function(e){//连接出错信息回调
	},
	onConnectionLost:function (){//连接断开丢失回调
	}
});

2.断开mqtt连接

接口：disconnect(options)
参数：options

//案例
cordova.plugins.CordovaMqTTPlugin.disconnect({
      success:function(s){//连接断开成功回调
	},
	error:function(e){//连接断开出错信息回调
	}
});

3.订阅主题

接口：subscribe(options)
参数：options
参数说明：
options={
  topic:“主题”
  qos:“发送质量”
}

//案例
cordova.plugins.CordovaMqTTPlugin.subscribe({
 topic:"topic/*",
  qos:0,
    success:function(s){//订阅主题成功回调
	},
	error:function(e){//订阅主题出错信息回调
	}
});

4.解除订阅主题

接口：unsubscribe(options)
参数：options
参数说明：
options={
  topic:“主题”
}

//案例
cordova.plugins.CordovaMqTTPlugin.unsubscribe({
      topic:"topic/*",
     success:function(s){//解除订阅主题成功回调},
	error:function(e){//解除订阅主题出错信息回调}
});

5.向主题发送信息

接口：publish(options)
参数：options
参数说明：
options={
  topic:“主题”
  qos:“发送质量”
  payload:"发送信息"
}

//案例
cordova.plugins.CordovaMqTTPlugin.publish({
	topic:"topic/*",
  	qos:0
    	payload:'hello world'
        success:function(s){//发送信息成功回调
	},
	error:function(e){//发送信息出错信息回调
	}

});

6.设置侦听接收信息的主题

接口：listen(theme,callback)
参数说明：
  theme:“正则匹配相关的主题”
  callback:"开启侦听回调"

//案例
cordova.plugins.CordovaMqTTPlugin.listen(theme:"topic/*",
       function(e){//开启侦听回调
});

surajrao/ios-plugin-mqtt