华为云物联网平台的C#应用开发（基本接口调用）

大家好，之前先后发布了华为云IOT的Java、Android、微信小程序的华为云物联网平台的上位机应用开发教程，基本介绍了不同环境下的华为云物联网平台的接口调用方法，最近接到了两个小伙伴咨询华为云物联网平台的C#应用开发问题，其实本质都是一样的，像查询设备属性下发命令等功能在应用侧开发都是以Http的GET或POST请求完成接口调用的形式，仔细查看代码的话其实与Android那期的开发教程有很大的相似之处，本期就带大家使用Visual Studio完成C#的窗体应用开发完成华为云物联网平台的基本接口调用。

一、新建工程与核心类

1. 新建工程

2. 新建类（用于完成核心功能）

二、认证鉴权

1. 文档介绍

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

上图的最后一行，我们可以看到，官方给出了一个调用IAM用户Token（使用密码）的帮助信息，所我们需要准备如下信息(获取IAM用户Token（使用密码）_统一身份认证服务 IAM_API参考_API_Token管理_华为云)：

在浏览上图教程中，我们可以看到我们需要 IAM用户所属帐号名、IAM用户名、IAM用户密码、项目名称所属（项目ID），然后我们将准备的参数填入下述的JSON数据体，并且在完成请求解析出接口返回的响应消息头中“X-Subject-Token”值，其值就是需要获取的用户Token：

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";

2.获取token的方法：

引入命名空间：using System.Net;

  String HUAWEINAME = "xxxxxxx";       //华为账号名
  String IAMINAME = "xxxxxxx";         //IAM账户名
  String IAMPASSWORD = "xxxxxxx";      //IAM账户密码
  String project_id = "xxxxxxx";       //产品ID
  String device_id = "xxxxxxx";        //设备ID
  String service_id ="xxxxxxx";        //服务ID
  String commands = "xxxxxxx";         //命令名称
  String token= "xxxxxxx";             //获取的token
 /*函数功能：获取token
 *返回值：token字符串
 *参数：  无
 * USER：IOT趣制作
 * */
public string GetToken()
{
  Console.WriteLine("正在获取token...
");
  string URL = "https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens ";
String data = "{" + """ + "auth" + """ + ": {" + """ + "identity" + """ + ": {" + """ + "methods" + """ + ": [" + """ + "password" + """ + "]," + """ + "password" + """ + ": {" + """ + "user" + """ + ":{" + """ + "domain": {"name": "" + HUAWEINAME + ""},"name": "" + IAMINAME + "","password": "" + IAMPASSWORD + ""}}},"scope": 
  {"project": {"name": "cn-north-4"}}}}";
  Encoding encoding = Encoding.Default;
  HttpWebRequest request = 
  (HttpWebRequest)WebRequest.Create(URL);
  request.Method = "post";
  request.ContentType = "application/json";
  byte[] buffer = encoding.GetBytes(data);
  request.ContentLength = buffer.Length;
  request.GetRequestStream().Write(buffer, 0, buffer.Length);
  HttpWebResponse response = 
  (HttpWebResponse)request.GetResponse();
  Console.WriteLine(response);
  token = response.GetResponseHeader("X-Subject-Token");
  Console.WriteLine("Token:" + token);
  return token;
}

3.添加调用：

HuaweiIOT dev1 = new HuaweiIOT();
dev1.GetToken();

4.运行：

【补充】由于我们获取的TOKEN是有24小时有效期的，大家可以在获取token后去生成token.txt文件，当过期时再重新获取，本教程不在次延伸扩展。

四、获取设备影子解析设备属性

1. 查看文档

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

我们需要的URI

可知我们的请求URL：”https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/”+ project_id + “/devices/”+ device_id + “/shadow”;

响应样例：

2.添加JSON程序包

3.引入命名空间

using System.IO;
using Newtonsoft.Json.Linq;

4.具体方法：

/*函数功能：通过设备影子获取设备属性
*返回值：无
*参数： 无
* USER：IOT趣制作
* */
public void GetProByShadow()
{
 Console.WriteLine("正在获取设备影子...
");
 String jsonShadow = "";
 String URL = "https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/" + project_id + "/devices/" + device_id + "/shadow";
 URL = String.Format(URL, project_id, device_id);
 Console.WriteLine("URL:" + URL);
 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
 request.Method = "GET";
 request.ContentType = "application/json";
 if (token == "") GetToken();
 request.Headers.Add("X-Auth-Token", token);
 HttpWebResponse response = (HttpWebResponse)request.GetResponse();
 Stream responseStream = response.GetResponseStream();
 StreamReader streamReader = new StreamReader(responseStream, Encoding.UTF8);
 jsonShadow = streamReader.ReadToEnd();
 streamReader.Close();
 responseStream.Close();
 Console.WriteLine("shadow:" + jsonShadow);
 JObject arr = JObject.Parse(jsonShadow);
 Console.WriteLine(arr);
 String shadowstr = "";
 if (arr.ContainsKey("shadow") == true)
 {
  shadowstr = arr["shadow"][0]["reported"]["properties"].ToString();
  Console.WriteLine(shadowstr);
 }
 properties mydev = new properties();
 JObject pro = JObject.Parse(shadowstr);
 mydev.temp = pro["temp"].ToString();
 mydev.humi = pro["humi"].ToString();
 mydev.light = pro["light"].ToString();
 Console.WriteLine("temp:" + mydev.temp + ",humi:" + mydev.humi + ",light:" + mydev.light);
 }
 //设备属性类别与属性值
 public class properties
 {
  public string temp { get; set; }
  public string humi { get; set; }
  public string light { get; set; }
 }

我们在调用接口后返回的json数据具体内容各不相同，但整体格式是一样的，我上述程序对应的格式如下，大家根据自己的实际JSON数据进行解析：

添加调用并运行：

dev1.GetProByShadow();

五、设备命令的下发

老样子，我们依旧查看华为云帮助文档（下发设备命令_设备接入 IoTDA_API参考_应用侧API参考_设备命令_设备同步命令_华为云）

我们得到的信息：

同步命令下发需要设备在线

URI为：

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

消息体是：

String body=”{“paras”:{“”+”*****”+”””+”:”+”*****”+”},”service_id”:”***** “,”command_name”:”*****”}”;

我们写一下实现方法：

/*函数功能：向设备下发同步命令（开灯：led=1）
*返回值：无
*参数： 无
* USER：IOT趣制作
* */
public void SetCommand()
{
 Console.WriteLine("下发命令,led:1");
 string URL = "https://iotda.cn-north-4.myhuaweicloud.com/v5/iot/" + project_id + "/devices/" + device_id + "/commands";
 //开灯命令
 String bodyData = "{"paras":{"" + "led" + """ + ":" + "1" + "},"service_id":"Dev_data","command_name":"Control"}";
 Encoding encoding = Encoding.Default;
 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(URL);
 request.Method = "POST";
 request.ContentType = "application/json";
 if (token == "") GetToken();
 request.Headers.Add("X-Auth-Token", token);
 byte[] buffer = encoding.GetBytes(bodyData);
 request.ContentLength = buffer.Length;
 request.GetRequestStream().Write(buffer, 0, buffer.Length);
}

添加调用并运行

设备响应命令需要在设备接收到命令后及时完成上报，功能由设备完成，不在此扩展讲解，我使用MQTT模拟响应后，在设备的消息跟踪可看到下面的效果，如果设备没有及时响应，不影响命令发送，但会报告同步命令响应异常的警告, 注意：同步命令需要在设备在线时才会发送成功，具体查看接口文档的错误码介绍.

   通过上述两个接口的调用，相信大家已经掌握的基本的接口使用方法，所有代码已经在上面贴出，如果需要上述工程文件，公众 HAO回复“华为云C#”即可，如果在开发过程中遇到问题，欢迎大家在vx留言提出，看到后会及时回复。