系列教程目录

 (一) 连接阿里云IOT <https://www.cnblogs.com/whuanle/p/10780220.html>

 (二) 设置委托事件 <https://www.cnblogs.com/whuanle/p/10786991.html>

 (三) 上报属性 <https://www.cnblogs.com/whuanle/p/10793392.html>

 (四)  SDK文档 属性、方法、委托、类 <https://www.cnblogs.com/whuanle/p/10798148.html>


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

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

下载三个库,头部引入 即可使用
using AliIOTXFClient;
示例下载地址

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

本章使用示例 AliIOTXF.One

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

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

创建一个产品

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



创建设备

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



 

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

<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 地域
<https://help.aliyun.com/document_detail/40654.html?spm=a2c4g.11186623.2.17.6a346de2Uyiqq4>
,把对应的 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 的教程就到这里了