智汇云-企业数智化核心引擎

首页> 开发者中心>物联网平台>设备接入开发指南>基于设备端SDK开发>Android SDK指导

## 1.说明

* **MQTT SDK 支持的最低系统版本为 Android 4.1**

*   使用本文档接入MQTT SDK之前，需要按照平台说明文档进行注册，企业认证及其他操作。使用本文档时，假设已经按照平台的说明，完成了所有操作。
*   MQTT SDK包括了两部分功能：一型一密接口获取DeviceSecret，mqtt 协议服务。
*   MQTT SDK服务启动之前需要获取调用一型一密接口获取DeviceSecret

## 2.接入流程

### 2.1 添加sdk
将libmqttxxx.jar放入lib目录并添加依赖
### 2.2 权限
在AndroidManifest.xml文件中添加以下权限：

&lt;uses-permission android:name="android.permission.WAKE_LOCK" /&gt;
    &lt;uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /&gt;
    &lt;uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /&gt;
    &lt;uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /&gt;
    &lt;uses-permission android:name="android.permission.INTERNET" /&gt;

### 2.3 组件

在AndroidManifest.xml文件的`application`节点添加以下组件：

&lt;service android:name="org.eclipse.paho.android.service.MqttService" /&gt;

### 2.4 混淆
如果应用有混淆，请添加一下配置：

-keep class com.qihoo.mqtt.IoTMqttManager{*;}
    -keep class com.qihoo.mqtt.IoTMqttConfig{*;}
    -keep class com.qihoo.mqtt.ErrorMessage{*;}
    -keep class com.qihoo.mqtt.IIoTMessageListener{*;}
    -keep class com.qihoo.mqtt.topic.IotService{*;}
    -keep class com.qihoo.mqtt.topic.Payload{*;}
    -keep class com.qihoo.mqtt.topic.IoTThingsModelManager{*;}
    -keep class com.qihoo.mqtt.util.**{*;}
    -keep class com.qihoo.mqtt.thirdparty.devicesecret.**{*;}
    -keep class com.qihoo.mqtt.MqttUrlProtocol{*;}

### 2.5 初始化
初始化的主要工作是设置productKey，deviceName, productSecret, crt文件名以及物模型的初始化，示例代码如下：

```java
IoTMqttConfig.setProductKey(this,"f9ac7bc09524");
IoTMqttConfig.setProductSecret("6437a2bba202");
IoTMqttConfig.setDeviceName(this,"lk_load_device1000001");
IoTMqttConfig.setRootCrt("root.crt");
try {
    IoTThingsModelManager.getInstance().init();
} catch (Exception e) {

}
```
### 2.6 获取deviceSecret
 调用3.1.3节的接口，获取deviceSecret
### 2.7 设置回调监听
 调用第3.5.6节，设置回调监听，回调主要监听连接状态，服务端下发的消息，回调接口在3.6节说明。
### 2.8 添加服务
调用`IoTThingsModelManager.getInstance().addService(identifier)`添加服务
### 2.9 配置
配置属性以及事件上传相关的qos以及retain标志，本步骤不是必须的，如未设置，则会使用默认值，示例代码如下：

```java
IoTThingsModelManager.getInstance().setPropertyTopicQos(1);
IoTThingsModelManager.getInstance().setPropertyPostTopicQos(1);
IoTThingsModelManager.getInstance().setEventPostTopicQos(1);
IoTThingsModelManager.getInstance().setPropertyPostTopicRetain(false);
IoTThingsModelManager.getInstance().setEventPostTopicRetain(false);
```

### 2.10 启动服务

调用`IoTMqttManager.getInstance(context).start()`启动服务。

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

物联网平台