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

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

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

一、新建工程与核心类

1. 新建工程

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

2. 新建类(用于完成核心功能)

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

二、认证鉴权

1. 文档介绍

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

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

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

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

在浏览上图教程中,我们可以看到我们需要 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;
}

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

3.添加调用:

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

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

4.运行:

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

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

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

1. 查看文档

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

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

我们需要的URI

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

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

响应样例:

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

2.添加JSON程序包

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

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数据进行解析:

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

添加调用并运行:

dev1.GetProByShadow();

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

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

五、设备命令的下发

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

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

我们得到的信息:

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

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);
}

添加调用并运行

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

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

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

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

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

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

 

本文章来源于互联网,如有侵权,请联系删除!原文地址:华为云物联网平台的C#应用开发(基本接口调用)

相关推荐: 工业物联网·数控机床现场数据采集与边缘计算方案

随着物联网技术的不断深究,工业物联网也因此得到了快速发展。在如今的环境下,智能工厂、智能生产、智能物流成为工业发展的方向,数控机床是工作于生产第一线,直接参与生产加工,是智能生产的重要一环,数控机床设备需求大幅增加,由于机床设备厂商产品覆盖范围广泛,售后服务区…