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

首页> 开发者中心>物联网平台>设备接入开发指南>基于设备端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开发平台

视觉分析

内容审核

人脸与人体识别

OCR识别

图像技术

AI市场

基础组件

视频应用

视频工具

物联网平台

网络与CDN

应用开发

研发效能

视频应用

企业工具

安全应用

云计算

大数据

容器服务

AI开发平台

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

物联网平台