一、MQTT简介:
1、MQTT 是一种基于发布订阅模型的即时通讯协议,它被设计为一个极其轻量级的发布/订阅消息传输协议。对于需要较小代码占用空间和/或网络带宽非常宝贵的远程连接非常有用,是专为受限设备和低带宽、高延迟或不可靠的网络而设计,所以主要应用于物联网设备中。
2、MQTT的基础知识
(1)服务器地址(可以使用MQTT官方提供的在线地址进行测试):brokerUrl =“tcp://mqtt.p2hp.com:1883”
(2)clientId:(作为客户端的标识),这里我使用的是AndroidID,获取不到的话就使用生成的一个UUID
(3)CleanSession:设置不持久化的话,每次都是一次新会话
(4)keepAliveInterval:发送心跳包的时间
3、MQTT的订阅与发布相关概念:
(1) 订阅
这里的概念就好像你微博关注了一个博主,然后当博主发布新的动态,你这就可以收到,而这里的订阅就是类似关注,订阅的主题格式跟文件路径差不多,比如订阅一个topic/1,当然这里也有带通配符的订阅方式比如topic/#,#的意思就是匹配所有,也就是当你订阅了topic/#的主题你就可以收到所有topic开头的主题消息,像topic/1、topic/2、topic/3等。
(2) 发布
发布消息的时候也需要指定一个主题,比如topic/1,但是不能指定带通配符的主题。
(3) QOS
另外还有一个比较重要的概念就是QOS(服务质量),这里有3个值(0,1,2),代表的意义如下:
0:代表,Sender 发送的一条消息,Receiver 最多能收到一次,也就是说 Sender 尽力向 Receiver 发送消息,如果发送失败,也就算了。
1:代表,Sender 发送的一条消息,Receiver 至少能收到一次,也就是说 Sender 向 Receiver 发送消息,如果发送失败,会继续重试,直到 Receiver 收到消息为止,但是因为重传的原因,Receiver 有可能会收到重复的消息。
2:代表,Sender 发送的一条消息,Receiver 确保能收到而且只收到一次,也就是说 Sender 尽力向 Receiver 发送消息,如果发送失败,会继续重试,直到 Receiver 收到消息为止,同时保证 Receiver 不会因为消息重传而收到重复的消息。
想了解更多相关的MQTT知识请查看https://mqtt.p2hp.com/software
二、相关配置
1、访问MQTTX:全功能 MQTT 客户端工具下载并配置MQTTX,具体如何请访问MQTTX官方文档,这里不在复述。也可以使用MQTT公共服务器,不过也要申请免费的公共 MQTT 服务器 | EMQ (emqx.com)
2、Android MQTT 配置
(1)引入相关库
// MQTT
implementation'org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.5'
(2)添加必要的权限
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
三、Android实现MQTT客户端
1、创建MQTT客户端:在你的Activity或Service中,创建并配置MQTT客户端。这包括设置broker URL,客户端ID,以及可选的用户名和密码。
String brokerUrl = "tcp://your_mqtt_broker:1883";
String clientId = "your_client_id";
MqttClient mqttClient = new MqttClient(context, clientId, new MemoryPersistence());
MqttConnectOptions connOpts = new MqttConnectOptions();
connOpts.setCleanSession(true);
2、连接到MQTT broker:使用上面创建的MqttClient对象连接到MQTT broker。
try {
mqttClient.connect(connOpts);
} catch (MqttException e) {
e.printStackTrace();
}
3、订阅主题:一旦连接成功,你可以订阅感兴趣的主题。
String topic = "your/topic";
int qos = 0;
try {
mqttClient.subscribe(topic, qos);
} catch (MqttException e) {
e.printStackTrace();
}
4、接收消息:为了接收订阅主题上的消息,需要设置一个消息监听器。
mqttClient.setCallback(new MqttCallback() {
@Override
public void connectionLost(Throwable cause) { }
@Override
public void messageArrived(String topic, MqttMessage message) throws Exception {
// 处理接收到的消息
}
@Override
public void deliveryComplete(IMqttDeliveryToken token) { }
});
5、发布消息:可以使用MQTT客户端发布消息到特定主题,也可以在APP端如下
String topic = "your/topic";
String payload = "your_message";
MqttMessage message = new MqttMessage(payload.getBytes());
message.setQos(0); // 设置QoS等级
try {
mqttClient.publish(topic, message);
} catch (MqttException e) {
e.printStackTrace();
}
6、处理连接和断开连接:确保在应用程序的适当生命周期阶段(如onPause或onDestroy)处理连接和断开连接。
最后,处理异常情况:适当处理可能出现的异常情况,例如网络中断或broker不可用。
测试:确保在不同的网络条件和场景下测试你的MQTT客户端实现。