华为云IOT Android应用开发详细教程

（Android Studio开发）

第〇章    简介

      大家好，上一期发布的教程叫大家如何利用华为云物联网平台提供的官方Java Demo去编写Java上位机程序，由于主要是用的是GET请求去查询设备影子和查询设备，之后接到了很多小伙伴私信咨询POST请求的实现，现在带着大家，写一个不基于官方Java Demo，而是完全参考于华为云帮助文档去写的一个Android应用，具体用到了POST请求获取鉴权的Token、设备命令下发，Get请求获取设备属性影子数据（依旧是用于解析属性）和查询设备（依旧是用于解析设备在线状态），先给大家看一下最终效果：

第一章    提前准备

1. Android Studio IDE（模拟器可联网）
2. 华为云设备接入IOTDA
3. MQTT.fx

第二章    详细步骤

    1. 新建工程

   2. 新建一个类，实现我们需要的所有方法

• 认证鉴权

根据华为云官方提供的帮助文档，我们可以知道，在调用接口前，我们需要完成认证鉴权，我们本次教程采用的是Token认证（帮助文档参考链接：认证鉴权_设备接入 IoTDA_API参考_应用侧API参考_如何调用API_华为云）

       上图的最后一行，我们可以看到，官方给出了一个调用IAM用户Token（使用密码）的帮助信息

              通过上述界面我们可以知道，该接口的URI以及需要准备的参数，大家可以仔细阅读，教程中我们直接查看页面中的示例：

我们需要准备的参数有：

  IAM用户所属帐号名、IAM用户名、IAM用户密码、项目名称所属

然后我们将准备的参数填入上述的JSON数据体

String postbody="{"+"\""+"auth"+"\""+": {"+"\""+"identity"+"\""+": {"+"\""+"methods"+"\""+": ["+"\""+"password"+"\""+"],"+"\""+"password"+"\""+": {"+"\""+"user"+"\""+":{"+"\""+"domain\": {\"name\": \"********\"},\"name\": \"********\",\"password\": \"********\"}}},\"scope\": {\"project\": {\"name\": \"cn-north-4\"}}}}";
String strurl="https://iam.cn-north-4.myhuaweicloud.com"+"/v3/auth/tokens?nocatalog=false";

现在我们写一个获取token的方法：

public static String gettoken() throws Exception
{

    String postbody="{"+"\""+"auth"+"\""+": {"+"\""+"identity"+"\""+": {"+"\""+"methods"+"\""+": ["+"\""+"password"+"\""+"],"+"\""+"password"+"\""+": {"+"\""+"user"+"\""+":{"+"\""+"domain\": {\"name\": \"********\"},\"name\": \"********\",\"password\": \"********\"}}},\"scope\": {\"project\": {\"name\": \"cn-north-4\"}}}}";

    String strurl="https://iam.cn-north-4.myhuaweicloud.com"+"/v3/auth/tokens?nocatalog=false";
    URL url = new URL(strurl);
    HttpURLConnection urlCon = (HttpURLConnection)url.openConnection();
    urlCon.addRequestProperty("Content-Type", "application/json;charset=utf8");

    urlCon.setDoOutput(true);
    urlCon.setRequestMethod("POST");
    urlCon.setUseCaches(false);
    urlCon.setInstanceFollowRedirects(true);
    urlCon.connect();

    BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(urlCon.getOutputStream(),"UTF-8"));
    writer.write(postbody);
    writer.flush();
    writer.close();
    Map headers = urlCon.getHeaderFields();
    Set<String> keys = headers.keySet();
    for( String key : keys ){
        String val = urlCon.getHeaderField(key);
        System.out.println(key+"    "+val);
    }
    return null;
}

然后我们在主函数中调用一下

public httpGetHuaweiIOT()throws Exception
{
    gettoken();
}

我们选择运行

我们检查控制台的输出

接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token，此时我们可以修改一下函数，在函数最后加上这两行：

String token = urlCon.getHeaderField("X-Subject-Token");
System.out.println("X-Subject-Token"+" : "+token);

返回值null改为return token;我们再run一下

此时我们的认证鉴权就完事了。（文章后面我们会修改类，把gettoken函数写在类的构造函数内调用）

【延伸】现在的postbody参数时我们写死的，大家也可以把参数做成变量传递进去；由于我们获取的TOKEN是有24小时有效期的，大家也可以学着华为云提供的java Demo在获取token以后去生成token.text文件，当过期时再重新获取，否则直接读取token保存的数据，本教程不在次延伸扩展。

接下来我们完成通过查询设备属性影子来获取设备属性信息。

• 获取设备影子解析属性

首先我们查看华为云官方提供的帮助文档（https://support.huaweicloud.com/api-iothub/iot_06_v5_0079.html）

              我们需要的URI

我们可以这么拼接URI

String strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s/shadow";

String project_id="*********";
String device_id="*********";
strurl = String.format(strurl, project_id,device_id);

需要注意的是，除了上述两个必备参数以外，我们的token在这就派上用场了

写程序之前，我们先导入安装一个jackson-databind、jackson-core、jackson-annotations的jar，我用的是jackson-databind-2.8.1.jar、 jackson-core-2.8.1.jar 和jackson-annotations-2.8.1.jar (大家可在网站上搜索下载，或者在文章末尾下载)

我们切换为Java的project目录，在app/libs中粘贴并载入jar包

剩下的两个jar包也是这样操作，如下图所示

然后我们在类头中引入我们用到的路径

接下来我们编写获取设备影子数据函数：

public static String getdev() throws Exception
{
    String strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s/shadow";
    String project_id="*********";
    String device_id="********* ";
    strurl = String.format(strurl, project_id,device_id);
    String  token=gettoken();
    URL url = new URL(strurl);
    HttpURLConnection urlCon = (HttpURLConnection)url.openConnection();
    urlCon.addRequestProperty("Content-Type", "application/json");
    urlCon.addRequestProperty("X-Auth-Token",token);
    urlCon.connect();
    InputStreamReader is = new InputStreamReader(urlCon.getInputStream());
    BufferedReader bufferedReader = new BufferedReader(is);
    StringBuffer strBuffer = new StringBuffer();
    String line = null;
    while ((line = bufferedReader.readLine()) != null) {
        strBuffer.append(line);
    }
    is.close();
    urlCon.disconnect();
    String result = strBuffer.toString();
    System.out.println(result);
    return null;
}

主函数中run一下

public static void main(String[] args)throws Exception {
    //gettoken();
    getdevshadow();
}

我们在控制台可以看到第一行是获取的token，第二行是我们得到的设备影子json数据

大家可以在华为云设备接入IOTDA的控制台修改产品：

我们检查一下我们需要的数据：

在华为云控制台那可以看一下：

为了清楚的查看，我们格式化一下：

其中的“report”->”properties”内的数据为我们要解析的设备属性，我们在函数中加上下面几句进行提取

比如我们获取temp属性

String pro="temp";
ObjectMapper objectMapper = new ObjectMapper();
JsonNode jsonNode = objectMapper.readValue(result, JsonNode.class);
JsonNode tempNode = jsonNode.get("shadow").get(0).get("reported").get("properties").get(pro);
String attvaluestr = tempNode.asText();
System.out.println(pro+"=" + attvaluestr);

运行一下

为了方便调用，我们改造一下函数定义，给他添上参数，改为：

public static String getdev(String pro) throws Exception{}

主函数这么调用：

getdev("temp");
getdev("humi");
getdev("light");

我们跑一下：

为了能够调用，我们最后要把return null;改为return attvaluestr;

• 查询设备在线状态

同样我们查看华为云的帮助文档

   我们可以得主要区别是
    URI不同： "https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s;
     解析的数据不同，我们还是在getdev函数中进行修改，再给他加一个参数，如

public static String getdev(String mode,String pro) throws Exception

{

    String strurl="";
    if(mode.equals("shadow")) strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s/shadow";
    else if(mode.equals("status")) strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s";
    //-----下面的程序不做变化
    //-----省略

}

主函数调用就改为：

getdev("shadow","temp");
getdev("shadow","humi");
getdev("shadow","light");

运行结果是一样的

然后我们把最后的影子解析先注释掉：

//String pro="temp";
/*ObjectMapper objectMapper = new ObjectMapper();
JsonNode jsonNode = objectMapper.readValue(result, JsonNode.class);
JsonNode tempNode = jsonNode.get("shadow").get(0).get("reported").get("properties").get(pro);
String attvaluestr = tempNode.asText();
System.out.println(pro+"=" + attvaluestr);*/
//return attvaluestr;

加上return null;然后主函数添加：

getdev("status","");

运行一下：

我们把最后的数据格式化一下

其中status是我们需要提取的，我们取消原来的注释，改造一下解析数据的代码

ObjectMapper objectMapper = new ObjectMapper();
JsonNode jsonNode = objectMapper.readValue(result, JsonNode.class);
if(mode=="shadow")
{
    JsonNode tempNode = jsonNode.get("shadow").get(0).get("reported").get("properties").get(pro);
    String attvaluestr = tempNode.asText();
    System.out.println(pro+"=" + attvaluestr);
    return attvaluestr;
}
if(mode=="status")
{
    JsonNode statusNode = jsonNode.get("status");
   String statusstr = statusNode.asText();
    System.out.println("status = " + statusstr);
    return statusstr;
}
return "something is error ";

我们运行一下：

• 命令下发

老样子，我们依旧查看华为云帮助文档

我们得到的信息：

URI为：

strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s/commands";

消息体是：

String body="{\"paras\":{\""+"*****"+"\""+":"+"*****"+"},\"service_id\":\"***** \",\"command_name\":\"*****\"}";

我们写一下实现方法：

public String setCom(String com,String value) throws Exception{
    String strurl="";
    strurl="https://iotda.cn-north-4.myhuaweicloud.com"+"/v5/iot/%s/devices/%s/commands";
    String project_id="*****";
    String device_id="*****";
    strurl = String.format(strurl, project_id,device_id);
    URL url = new URL(strurl);
    HttpURLConnection urlCon = (HttpURLConnection)url.openConnection();
    urlCon.addRequestProperty("Content-Type", "application/json");
    String token=gettoken();
    urlCon.addRequestProperty("X-Auth-Token",token);
    urlCon.setDoOutput(true);
    urlCon.setRequestMethod("POST");
    urlCon.setUseCaches(false);
    urlCon.setInstanceFollowRedirects(true);
    urlCon.connect();

    String body = "{\"paras\":{\""+com+"\""+":"+value+"},\"service_id\":\"*****\",\"command_name\":\"*****\"}";

    BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(urlCon.getOutputStream(),"UTF-8"));
    writer.write(body);
    writer.flush();
    writer.close();

    InputStreamReader is = new InputStreamReader(urlCon.getInputStream());
    BufferedReader bufferedReader = new BufferedReader(is);
    StringBuffer strBuffer = new StringBuffer();
    String line = null;
    while ((line = bufferedReader.readLine()) != null) {
        strBuffer.append(line);
    }
    is.close();
    urlCon.disconnect();
    String result = strBuffer.toString();
    System.out.println(result);
    return result;
}

在主函数调用一下

setCom("led","1");

我们在华为云控制台的设备那查看

我们可以发现命令是成功的，但还有一个错误代码，那是因为设备不在线或没有对命令进行处理响应，这个我们交给设备处理，不在此介绍
另外设备需要订阅topic: $oc/devices/{device_id}/sys/commands/request_id={request_id}

同样在控制台也可以看到数据：

最后我们可以看到这个token每次都要调用，其实是没必要的，我们在这里把放到构造函数里：

String token="";
public huaweiIOT()throws Exception
{
    token=  gettoken();
}

最后我们删除的getdev的static声明，getdev函数的String  token=gettoken();，删除main函数,现在我们的函数结构是：

public class httpGetHuaweiIOT {

String token="";
public httpGetHuaweiIOT()throws Exception
{
    token=gettoken();
}
public String getAtt(String att,String mode) throws Exception{}
public String setCom(String com,String value) throws Exception{}

 这样我们的核心功能就完成了，接下来是安卓界面与逻辑部分

    3. MainActivity中调用方法

我们在protected void onCreate(Bundle savedInstanceState) {}添加一个线程用于获取数据和命令下次测试

Thread t = new Thread() {
    @Override
    public void run() {
        try {
            huaweiIOT hwiot=new huaweiIOT();
            System.out.println("获取状态");
            String str="";
            str=hwiot.getdev("status","");
            if(str.equals("ONLINE"))
            {
                str="设备在线";
            }
            else if(str.equals("OFFLINE"))
            {
                str="设备离线";
            }
            System.out.println("获取成功，状态："+str);
            System.out.println("获取温度");
            str=hwiot.getdev("shadow","temp");
            System.out.println("获取成功，温度："+str);
            str=hwiot.getdev("shadow","humi");
            System.out.println("获取成功，湿度："+str);
            str=hwiot.getdev("shadow","light");
            System.out.println("获取成功，光照强度："+str);
        }
        catch (Exception e) {
            e.printStackTrace();
            System.out.println("获取失败："+e.toString());
        }
    }
};
t.start();

注意，在run app之前我们要加入联网的权限，我们打开AndroidManifest文件，在<application>前添加下述：

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.INTERNET"/>

然后我们run一下app:

最后就是就是创建界面显示与逻辑设计啦

 

    5.结语

      到这里大家已经学习到了华为云物联网平台Android应用开发的基础操作啦，本期教程就到这里啦，大家可以完成自己的华为云物联网平台的Android应用开发；
      如果有需要上述参考工程，请微信搜索公众号“IOT趣制作”，回复关键字“华为云安卓”，领取教程的实例Demo，然后在HuaweiIOT类文件中填写参数信息运行即可。