EMQ (Erlang/Enterprise/Elastic MQTT Broker) 是基于 Erlang/OTP 平台开发的开源物联网 MQTT 消息服务器。Erlang/OTP 是出色的软实时(Soft-Realtime)、低延时(Low-Latency)、分布式(Distributed) 的语言平台。MQTT 是轻量的(Lightweight)、发布订阅模式(PubSub) 的物联网消息协议。
EMQ 项目设计目标是承载移动终端或物联网终端海量 MQTT 连接,并实现在海量物联网设备间快速低延时消息路由:
- 稳定承载大规模的 MQTT 客户端连接,单 服务器 节点支持50万到100万连接。
- 分布式节点集群,快速低延时的消息路由,单集群支持1000万规模的路由。
- 消息服务器内扩展,支持定制多种认证方式、高效存储消息到后端数据库。
- 完整物联网协议支持,MQTT、MQTT-SN、CoAP、WebSocket 或私有协议支持。
1、MQTT
协议特点
MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。MQTT协议是轻量、简单、开放和易于实现的,这些特点使它适用范围非常广泛。在很多情况下,包括受限的环境中,如:机器与机器(M2M)通信和物联网(IoT)。其在,通过卫星链路通信传感器、偶尔拨号的医疗设备、智能家居、及一些小型化设备中已广泛使用。
MQTT协议当前版本为,2014年发布的MQTT v3.1.1。除标准版外,还有一个简化版MQTT-SN
,该协议主要针对嵌入式设备,这些设备一般工作于百TCP/IP网络,如:ZigBee。
MQTT协议运行在TCP/IP或其他网络协议,提供有序、无损、双向连接。其特点包括:
- 使用的发布/订阅消息模式,它提供了一对多消息分发,以实现与应用程序的解耦。
- 对负载内容屏蔽的消息传输机制。
- 对传输消息有三种服务质量(QoS):
最多一次
,这一级别会发生消息丢失或重复,消息发布依赖于底层TCP/IP网络。即:<=1至多一次
,这一级别会确保消息到达,但消息可能会重复。即:>=1只有一次
,确保消息只有一次到达。即:=1。在一些要求比较严格的计费系统中,可以使用此级别
- 数据传输和协议交换的最小化(协议头部只有2字节),以减少网络流量
- 通知机制,异常中断时通知传输双方
2、网络传输与应用消息
MQTT
会构建底层网络传输:它将建立客户端到服务器的连接,提供两者之间的一个有序的、无损的、基于字节流的双向传输。
当应用数据通过MQTT
网络发送时,MQTT
会把与之相关的服务质量(QoS)和主题名(Topic)相关连。
3、MQTT
客户端
一个使用MQTT
协议的应用程序或者设备,它总是建立到服务器的网络连接。客户端可以:
- 发布其他客户端可能会订阅的信息
- 订阅其它客户端发布的消息
- 退订或删除应用程序的消息
- 断开与服务器连接
4、MQTT
服务器
MQTT
服务器以称为“消息代理”(Broker),可以是一个应用程序或一台设备。它是位于消息发布者
和订阅者
之间,它可以:
- 接受来自客户的网络连接
- 接受客户发布的应用信息
- 处理来自客户端的订阅和退订请求
- 向订阅的客户转发应用程序消息
5、MQTT
协议中的订阅、主题、会话
订阅(Subscription)
订阅包含主题筛选器(Topic Filter)和最大服务质量(QoS)。订阅会与一个会话(Session)关联。一个会话可以包含多个订阅。每一个会话中的每个订阅都有一个不同的主题筛选器。
会话(Session)
每个客户端与服务器建立连接后就是一个会话,客户端和服务器之间有状态交互。会话存在于一个网络之间,也可能在客户端和服务器之间跨越多个连续的网络连接。
主题名(Topic Name)
连接到一个应用程序消息的标签,该标签与服务器的订阅相匹配。服务器会将消息发送给订阅所匹配标签的每个客户端。
主题筛选器(Topic Filter)
一个对主题名通配符筛选器,在订阅表达式中使用,表示订阅所匹配到的多个主题。
负载(Payload)
消息订阅者所具体接收的内容
6、MQTT
协议中的方法
MQTT
协议中定义了一些方法(也被称为动作), 来于表示对确定资源所进行操作。 这个资源可以代表预先存在的数据或动态生成数据,这取决于服务器的实现。通常来说,资源指服务器上的文件或输出。
Connect,等待与服务器建立连接
Disconnect,等待MQTT
客户端完成所做的工作,并与服务器断开TCP/IP会话
Subscribe,等待完成订阅
UnSubscribe,等待服务器取消客户端的一个或多个topics
订阅
Publish,MQTT
客户端发送消息请求,发送完成后返回应用程序线程
7、选择 MQTT SDK 分为多种
以下介绍其中的两种 MQTTKit 和 MQTT-Client-Framework 这两种都是OC 使用
Swift 版本可参考 CocoaMQTT 1、 ** MQTTKit **
已经不更新 但是基本使用没问题
pod 'MQTTClient'
8、初始化 链接
MQTTCFSocketTransport *transport = (MQTTCFSocketTransport *)self.mqttSession.transport;
/*MQTTCFSocketEncoder *enc = [transport valueForKey:@"encoder"];
BOOL socketClosed = enc.stream.streamStatus<NSStreamStatusOpening || enc.stream.streamStatus>NSStreamStatusAtEnd;*/
BOOL connected = self.mqttSession.status == MQTTSessionStatusConnected;
BOOL connecting = self.mqttSession.status == MQTTSessionStatusConnecting;
if ((![self.mqttSession.userName isEqualToString:self.uid] || ![self.mqttSession.password isEqualToString:user.token]) || !(connecting || connected))
{
connected = NO;
[self internalClose];
if (!self.mqttSession)
{
self.mqttSession = [[MQTTSession alloc] init];
transport = [[MQTTCFSocketTransport alloc] init];
transport.host = kMQTTHost;
transport.port = kMQTTPort;
self.mqttSession.transport = transport;
self.mqttSession.keepAliveInterval = 5;
self.mqttSession.delegate = self;
[MQTTLog setLogLevel:DDLogLevelDebug];
}
self.mqttSession.userName = self.uid;
self.mqttSession.clientId = [NSString stringWithFormat:@"app:%@", self.uid];
self.mqttSession.password = user.token;
[self.mqttSession connect];
}
9、连接 返回状态
-(void)handleEvent:(MQTTSession *)session event:(MQTTSessionEvent)eventCode error:(NSError *)error{
if (eventCode == MQTTSessionEventConnected) {
NSLog(@"MQTT链接成功");
}else if (eventCode == MQTTSessionEventConnectionRefused) {
NSLog(@"MQTT拒绝链接");
}else if (eventCode == MQTTSessionEventConnectionClosed){
NSLog(@"MQTT链接关闭");
}else if (eventCode == MQTTSessionEventConnectionError){
NSLog(@"MQTT 链接错误");
}else if (eventCode == MQTTSessionEventProtocolError){
NSLog(@"MQTT 不可接受的协议");
}else{//MQTTSessionEventConnectionClosedByBroker
NSLog(@"MQTT链接 其他错误");
}
if (error) {
NSLog(@"链接报错 -- %@",error);
}
}
10、订阅主题
// 方法 封装 可外部调用
[self.mqttSession subscribeToTopic:@"example/#" atLevel:2 subscribeHandler:^(NSError *error, NSArray<NSNumber *> *gQoss){
if (error) {
NSLog(@"Subscription failed %@", error.localizedDescription);
} else {
NSLog(@"Subscription sucessfull! Granted Qos: %@", gQoss);
}
}]; // this is part of the block API
11、发送消息
[self.mqttSession publishData:jsonData onTopic:@"发送消息的主题 服务端定义" retain:NO qos:MQTTQosLevelAtMostOnce publishHandler:^(NSError *error) {
if (error) {
NSLog(@"发送失败 - %@",error);
}else{
NSLog(@"发送成功");
}
}];
12、收到发送的消息
-(void)newMessage:(MQTTSession *)session data:(NSData *)data onTopic:(NSString *)topic qos:(MQTTQosLevel)qos retained:(BOOL)retained mid:(unsigned int)mid
{
NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];
NSLog(@"EasyMqttService mqtt connect success %@",dic);
// 做相对应的操作
}
13、关闭MQTT-Client
-(void)closeMQTTClient{
[self.mqttSession disconnect];
[self.mqttSession unsubscribeTopics:@[@"已经订阅的主题"] unsubscribeHandler:^(NSError *error) {
if (error) {
DLog(@"取消订阅失败");
}else{
DLog(@"取消订阅成功");
}
}];
}