面向云技术架构 - 痴者工良

  • 首页
  • 工良写的电子书
    • kubernetes 教程
    • 从 C# 入门 Kafka
    • 多线程和异步
    • 动态编程-反射、特性、AOP
    • 表达式树
  • 本站文章导航
  • 隐私政策
愿有人陪你颠沛流离
遇到能让你付出的事物或者人,都是一种运气。
能遇到,就该珍惜。或许你们最终没能在一起,但你会切实地感受到力量。
正因为这样,那段相遇才变得有价值,才没有辜负这世间的每一段相遇。
  1. 首页
  2. .NET
  3. 正文

阿里云物联网 .NET Core 客户端 | CZGL.AliIoTClient:2. IoT 客户端

2019年12月15日 1695点热度 0人点赞 2条评论
内容纲要

文档目录:

  • 说明
  • 1. 连接阿里云物联网
  • 2. IoT 客户端
  • 3. 订阅Topic与响应Topic
  • 4. 设备上报属性
  • 4.1 上报位置信息
  • 5. 设置设备属性
  • 6. 设备事件上报
  • 7. 服务调用
  • 8. 委托事件
  • 9. 自定义委托事件方法

 

1) 客户端连接

CZGL.AliIoTClient 中,有两个连接到阿里云物联网服务器的方法:

public CZGL.AliIoTClient.ConnectCode ConnectIoT(string[] SubTopic, 
                                                [byte[] QOS = null], 
                                                [ushort keepAlivePeriod = 60])
public System.Threading.Tasks.Task<CZGL.AliIoTClient.ConnectCode> 
                                   ConnectIoTAsync(string[] topics, 
                                   [byte[] QOS = null], 
                                   [ushort keepAlivePeriod = 60])

参数说明及返回值:

参数名称 类型 说明
SubTopic string[] 要订阅的 Topic 列表,只有先订阅这个 Topic ,才会接收到服务器推送这个 Topic
QOS byte[] 每个Topic都配置一个QOS,如果为空,将会为每个Topic设置 QOS=0x00,注意QOS只有0,1,2三种,因此使用byte最合适
keepAlivePeriod ushort 存活监测周期,MQTT 通讯要求每间隔一段时间,客户端及时反馈,以此证明客户端的存活,超过这个周期,服务器会认为客户端已经掉线。
返回值 ConnectCode 是连接返回状态的代码,枚举类型,即使因为密钥错误、网络断开等造成连接失败,不会触发异常,会返回状态码

每个 Topic 都有 一个 QOS 属性,SubTopic 的 长度和 QOS 的长度应当一致,索引位置也要对应。

QOS 的含义:

  • QOS = 0 ,最多一次
  • QOS = 1,至少一次
  • QOS = 2,只有一次

ConnectCode:

当客户端尝试与服务器建立连接,可能成功也可能失败,此时会返回具体的连接状态信息,ConnectCode 枚举如下:

枚举名称 枚举值 说明
conn_accepted 0x00 连接成功
conn_refused_prot_vers 0x01 协议版本
conn_refused_ident_rejected 0x02 认证被拒绝
conn_refused_server_unavailable x03 服务器403/404等
conn_refused_username_password 0x04 账号密码错误
conn_refused_not_authorized 0x05 没有授权
unknown_error 0x06 其它未知错误

示例:

            var code = client.ConnectIoT(topics, null, 60);
            Console.WriteLine("连接状态:" + code);

2)断开连接

public bool ConnectIoTClose() 

断开连接,会彻底释放 AliIoTClientJson 对象,而不仅仅是离线,如需重新连接,请重新 new 一个对象;

示例:

 client.ConnectIoT(topics,null,60);

3) 查看状态

查看客户端是否与服务器保持连接:

public bool isConnected { get; }

示例:

Console.WriteLine("是否与服务器连接保持连接:" + client.isConnected);
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可
标签: core czgl net 云物 客户端
最后更新:2021年2月21日

痴者工良

高级程序员劝退师

点赞
< 上一篇
下一篇 >

文章评论

razz evil exclaim smile redface biggrin eek confused idea lol mad twisted rolleyes wink cool arrow neutral cry mrgreen drooling persevering
取消回复

文章目录
  • 文档目录:
  • 1) 客户端连接
  • 2)断开连接
  • 3) 查看状态

COPYRIGHT © 2022 whuanle.cn. ALL RIGHTS RESERVED.

Theme Kratos Made By Seaton Jiang

粤ICP备18051778号

粤公网安备 44030902003257号