.NET Core 跨平台物联网开发：连接阿里云IOT

Posted 2021-11-26 whuanle

系列教程目录

 (一) 连接阿里云IOT

 (二) 设置委托事件

 (三) 上报属性

 (四)  SDK文档 属性、方法、委托、类

 http://pan.whuanle.cn/index.php?dir=uploads/阿里云IOT/AliIOTXFclient-dll类库&response

下载三个库，头部引入 即可使用

using AliIOTXFClient;

示例下载地址

http://pan.whuanle.cn/index.php?dir=uploads/阿里云IOT/demo示例

本章使用示例 AliIOTXF.One

二，阿里云 IOT 创建产品设备 

打开地址 https://iot.console.aliyun.com/product

创建一个产品

节点类型选择设备、非网关，因为是直接对接有网络能力的设备。透传需要写 JS 解析脚本，Alink Json 使用方便、不易出错，也更便于理解。ID² 提供了双向身份认证能力，但是收费。

创建设备

创建成功后记得 “ 一键复制 ” ，然后存放到记事本等保存。(保不保存没事，可以到里面复制)

 

附上阿里云创建产品的文档 https://help.aliyun.com/document_detail/73705.html?spm=a2c4g.11174283.6.553.3a8b1668QRyRs7

创建后的设备

 

 三，创建项目，连接阿里云

随意创建一个 .NET Core 项目，引入三个 Dll，记得选择复制到本地。

 

头部引入

using AliIOTXFClient;

创建连接客户端

把一键复制的内容或到控制台--具体设备中，复制 ProductKey 和 DeviceName。

XFMQTT client = new XFMQTT(ProductKey, DeviceName);　　// 创建连接对象

初始化配置

 DeviceSecret 到控制台复制，Region ID 是地域，可以在控制台左上角看到地域名称，点击 查看阿里云 IOT 地域，把对应的 Region ID 复制下来。例如笔者的是华东2，对应 cn-shanghai。

client.Init(DeviceSecret, Region ID);　　// 初始化客户端

 添加要订阅的 Topic

需要具有 “订阅” 权限的 Topic 才能被订阅。并且只有 .../user/... 的，属于普通 Topic。这方面后面再说，看图。

update、update/error、get 属于默认的Topic。

 

 我们创建自定义的 Topic，点击 对应的 “产品”--查看 Topic 类列表，“自定义Topic类”

添加两个自定义的 Topic

 

 在项目代码中

            // 要订阅的Topic
            string[] topic = { client.CombineHeadTopic("PubData") };

 要订阅多个Topic，在里面添加即可。client.CombineHeadTopic() 方法可以根据Topic名称帮助生成完整的Topic。

当然，你也可以直接

string[] topic = { "/a1BiPoNawLI/${deviceName}/user/PubData" };

多个 Topic string[] topic = { top1,top2.,,,, };

绑定事件委托

 在连接服务器、收到 Topic、发布 Topic、发布属性、服务调用等各个环节，都有相应的委托。

这里使用默认的委托事件，后面慢慢如何自定义

            // 使用默认的委托事件
            client.UseDefaultEventHandler();

开始连接IOT服务器

            // 连接服务器
            client.ConnectMqtt(topic);

别忘记了加一行 Console.ReadKey();

 完整代码

            // 创建连接对象
            XFMQTT client = new XFMQTT("a1BiPoNawLI", "Raspberry");
            // 初始化客户端配置
            client.Init("2NOaBeqXcIzLQEhlJFEfKbWeug0o3m0c", "cn-shanghai");
            // 要订阅的Topic
            string[] topic = { client.CombineHeadTopic("PubData") };

            // 使用默认的委托事件
            client.UseDefaultEventHandler();

            // 连接服务器
            client.ConnectMqtt(topic);

            Console.ReadKey();

 

创建一般的连接客户端的步骤已经完成，运行程序

四，订阅 Topic 与发布 Topic

运行程序后，打开控制台--设备列表，会发现

 

发送 Topic

打开设备，找到 Topic 列表的 PubData，点击 ”发布“，输入任意字符(中文可能会乱码)，查看客户端会不会收到内容。

注：只有权限为订阅的Topic，能够向设备下发数据。

设备中，只有设置订阅该 Topic，在控制台发布消息时，才能收到此 Topic。在控制台多找几个Topic，试试发布一下就知道了。

 

发布Topic

上面的步骤实现了连接 IOT 平台并订阅 Topic，这样可以收到服务器的推送或者说收到数据了，Topic 可以订阅很多个，在客户端设置需要的 Topic，服务器能向客户端设备发布成功。下面来示范一下如何发布数据内容到服务器。

在代码后面加上

           while (true)
            {    
                string str=Console.ReadLine();

                // 推送内容到特定的 Topic
                client.Subscribe(client.CombineHeadTopic("SubData"),str);
            }

SubData 是我们要推送到的Topic。

完整代码如下(请替换 {***} 的对应内容)，红色部分是新增代码：

            // 创建连接对象
            XFMQTT client = new XFMQTT("{*产品名称*}", "{*设备名称*}");
            // 初始化客户端配置
            client.Init("{*密钥*}", "{*cn-shanghai*}");
            // 要订阅的Topic
            string[] topic = { client.CombineHeadTopic("PubData") };

            // 使用默认的委托事件
            client.UseDefaultEventHandler();

            // 连接服务器
            client.ConnectMqtt(topic);

            while (true)
            {    
                string str=Console.ReadLine();

                // 推送内容到特定的 Topic
                client.Subscribe(client.CombineHeadTopic("SubData"),str);
            }

            Console.ReadKey();

运行程序，随意输入内容。在控制台知道日志服务，查看设备的上行消息分析

IOT控制台中暂时没法查看到上传的消息内容。

使用了默认的委托方法，可以在控制台中复制文字，使用Json格数化看看结果。

简单使用 SDK 的教程就到这里了