阿里云物联网 .NET Core 客户端 | CZGL.AliIoTClient:3. 订阅Topic与响应Topic

简介: CZGL.AliIoTClient 将 Topic 分为五种分别是:普通Topic、属性上报、属性下发、事件上报、服务调用,除了普通 Topic,每种 Topic 都有消息的发送、响应。 普通 Topic ,消息发送或,根据 MQTT 协议,SDK 严格保证消息能够到达另一端。

CZGL.AliIoTClient 将 Topic 分为五种

分别是:普通Topic、属性上报、属性下发、事件上报、服务调用,除了普通 Topic,每种 Topic 都有消息的发送、响应。

普通 Topic ,消息发送或,根据 MQTT 协议,SDK 严格保证消息能够到达另一端。
设备推送属性、事件等数据到服务器,则服务器要响应,
服务器推送(下发)数据到设备,则设备要响应。
当然,这些响应可有可无,无实质的影响。

每种、每个 Topic 都有特定的 MQTT 通讯地址,这些地址已经在 CZGL.AliIoTClient 中自动生成,你仅需填写普通 Topic 的通讯地址即可。


1) 订阅 Topic

订阅 Topic 前,需要在阿里云物联网定义相应的 Topic 以及设置 订阅 权限,
普通 Topic ,使用 string[] 包含列表,然后在调用连接方法时作为参数传入,亦可在连接服务器后,添加需要的订阅。
普通 Topic 可以动态添加,属于 热订阅 。

使用方法:

 // 设置要订阅的Topic、运行接收内容的Topic
            string[] topics = new string[] { 
                                client.CombineHeadTopic("get"),
                                "/a1xrkGSkb5R/mire/user/get1" };

            client.ConnectIoT(topics,null,60);

Topic 地址比较长,你可以记录 .../user/ 后的内容,使用 CombineHeadTopic() 可自动生成,

client.CombineHeadTopic("get") 

2)响应

当你使用属性、事件、服务功能,对服务器进行数据传输时,服务器会做出响应,你可以选择接收响应,也可以不接收响应。
CZGL.AliIoTClient 默认不接收服务器的响应信息。实际上这些响应信息一般只在调测时需要。

响应方法 说明
OpenEventPostReply() 接收上报事件后服务器的响应
OpenPropertyPostReply() 接收设备属性上传后服务器的响应
OpenServicePostRaw() 允许服务器调用服务 新版本已经取消这个设置
OpenPropertyDownPost() 允许服务器下发设置设备属性指令

注意,这些响应,必须在连接客户端前设置,并且在客户端已经连接后,不能再使用以上方法,否则会弹出异常。
已修复,你可以在程序的任意阶段打开接收功能,任意取消和打开。

查看这些功能是否打开:

public CZGL.AliIoTClient.OpenTopic getOpenTopic()

OpenTopic 具有 8 个属性,用于获取或设置是否打开某种功能的接收。

属性 说明 默认值
CommonTopic 是否接收普通Topic 固定为true,不能更改
PropertyUpRawReplyTopic 设备上传透传属性数据后服务器的响应 false
PropertyPostReplyTopic 设备上传Alink json属性数据后服务器的响应 false
PropertyDownRaw 服务器下发设置属性的命令,透传 false
PropertyDownPost 服务器下发设置属性的命令,Alink json false
EventUpRawReply 设备事件上报,接收服务器的响应,透传 false
EventPostReply 设备事件上报,接收服务器的响应,Alink json false
ServiceDownRaw 服务器调用服务,透传 false
ServicePostRaw 服务器调用服务,Alink json false

由于区分 透传 和 Alink json,若是透传,设置上面的 Alink json 项,是无效的,反之亦然。


3)连接服务器后


在连接服务器后,你还可以增加要订阅的普通 Topic:

public void TopicAdd(string[] topics, [byte[] QOS = null])

示例:

client.TopicAdd(new string[]{ client.CombineHeadTopic("get") })

移除已经订阅的 Topic:

public void TopicRemove(string[] topics)

在连接服务器后,可以取消接收服务器的响应信息,但是不能再重新接收。

方法 说明
CloseEventPostReply() 不再接收设备上传事件后服务器的响应
ClosePropertyPostReply() 不再接收设备上传属性后服务器的响应
CloseServicePostRaw() 不允许服务器下发调用设备服务的指令已删除此设置
ClosePropertyDownPost() 不允许服务器下发设置设备属性的指令

你可以在客户端连接服务器后,取消接收响应。但是,取消后,不能再订阅!
已修复,你可以在程序任意阶段取消后再打开接收。


4) Topic 说明

获取已经订阅的Topic列表:

public string[] GetSubedList { get; }

示例:

var topicList = client.GetSubedList;

服务器设置设备属性、调用服务等功能,由于采用 MQTT 通讯,是订阅/推送形式的,所以,无论什么功能的数据传输,本质还是Topic。
因此,那些设备属性上报、设置设备属性等,可以配置 Topic 属性。

CZGL.AliIoTClient 中,客户端可以订阅需要的 Topic,连接服务器后,服务器可以向所有 Topic 发送数据,但只有客户端指定订阅的 Topic,客户端才会接收到推送,不然无论在控制台怎么点击发送,客户端都是不会接收到的。

有个地方需要注意的是,对于普通Topic,是随客户端连接时的配置,决定服务器是否能够推送消息到客户端,动态的。

而属性、事件、服务这些功能,会保存上一次的配置。当你打开

client.OpenPropertyPostReply();

接收属性上传到服务器的响应后,在程序删除

client.OpenPropertyPostReply();

再次运行,依然会接收到响应,除非设置

client.ClosePropertyPostReply();

设备上传数据到服务器,服务器会做出响应,当然,服务器设置设备属性、调用设备服务时,客户端也可以做出响应。将在后面的章节讲述。

相关实践学习
阿里云AIoT物联网开发实战
本课程将由物联网专家带你熟悉阿里云AIoT物联网领域全套云产品,7天轻松搭建基于Arduino的端到端物联网场景应用。 开始学习前,请先开通下方两个云产品,让学习更流畅: IoT物联网平台:https://iot.console.aliyun.com/ LinkWAN物联网络管理平台:https://linkwan.console.aliyun.com/service-open
目录
相关文章
|
Linux Android开发 iOS开发
基于.Net开发的ChatGPT客户端,兼容Windows、IOS、安卓、MacOS、Linux
基于.Net开发的ChatGPT客户端,兼容Windows、IOS、安卓、MacOS、Linux
472 0
|
开发框架 .NET C#
在 ASP.NET Core 中创建 gRPC 客户端和服务器
本文介绍了如何使用 gRPC 框架搭建一个简单的“Hello World”示例。首先创建了一个名为 GrpcDemo 的解决方案,其中包含一个 gRPC 服务端项目 GrpcServer 和一个客户端项目 GrpcClient。服务端通过定义 `greeter.proto` 文件中的服务和消息类型,实现了一个简单的问候服务 `GreeterService`。客户端则通过 gRPC 客户端库连接到服务端并调用其 `SayHello` 方法,展示了 gRPC 在 C# 中的基本使用方法。
389 5
在 ASP.NET Core 中创建 gRPC 客户端和服务器
|
存储 消息中间件 NoSQL
Redis 入门 - C#.NET Core客户端库六种选择
Redis 入门 - C#.NET Core客户端库六种选择
947 8
|
网络协议 Unix Linux
一个.NET开源、快速、低延迟的异步套接字服务器和客户端库
一个.NET开源、快速、低延迟的异步套接字服务器和客户端库
325 4
|
缓存 运维 前端开发
阿里云云效操作报错合集之如何解决在使用流水线构建net8应用时遇到无法构建的报错
本合集将整理呈现用户在使用过程中遇到的报错及其对应的解决办法,包括但不限于账户权限设置错误、项目配置不正确、代码提交冲突、构建任务执行失败、测试环境异常、需求流转阻塞等问题。阿里云云效是一站式企业级研发协同和DevOps平台,为企业提供从需求规划、开发、测试、发布到运维、运营的全流程端到端服务和工具支撑,致力于提升企业的研发效能和创新能力。
|
API
使用`System.Net.WebClient`类发送HTTP请求来调用阿里云短信API
使用`System.Net.WebClient`类发送HTTP请求来调用阿里云短信API
305 0
|
NoSQL 大数据 Redis
分享5款.NET开源免费的Redis客户端组件库
分享5款.NET开源免费的Redis客户端组件库
311 1
|
JSON 编解码 Go
Golang深入浅出之-HTTP客户端编程:使用net/http包发起请求
【4月更文挑战第25天】Go语言`net/http`包提供HTTP客户端和服务器功能,简化高性能网络应用开发。本文探讨如何发起HTTP请求,常见问题及解决策略。示例展示GET和POST请求的实现。注意响应体关闭、错误处理、内容类型设置、超时管理和并发控制。最佳实践包括重用`http.Client`,使用`context.Context`,处理JSON以及记录错误日志。通过实践这些技巧,提升HTTP编程技能。
317 1
|
Go 开发者
Golang深入浅出之-HTTP客户端编程:使用net/http包发起请求
【4月更文挑战第24天】Go语言的`net/http`包在HTTP客户端编程中扮演重要角色,但使用时需注意几个常见问题:1) 检查HTTP状态码以确保请求成功;2) 记得关闭响应体以防止资源泄漏;3) 设置超时限制,避免长时间等待;4) 根据需求处理重定向。理解这些细节能提升HTTP客户端编程的效率和质量。
290 1
|
Java Maven
【开源视频联动物联网平台】vertx写一个mqtt客户端
【开源视频联动物联网平台】vertx写一个mqtt客户端
574 1

相关产品

  • 物联网平台