阿里云物联网.NET Core客户端CZGL.AliIoTClient使用指南

在阿里云IoT的.NET Core开发过程中，客户端连接是构建物联网应用的基础与核心环节。CZGL.AliIoTClient库为开发者提供了两种连接方式：同步连接（ConnectIoT）与异步连接（ConnectIoTAsync）。其中，同步方法适用于逻辑简单的场景，而异步方法则更适合需要并行处理或保持用户界面流畅响应的应用。接下来，我们直接解析这两个方法的具体实现。

1）客户端连接

该库定义了两个核心连接方法，分别对应同步与异步操作，其方法签名如下：

public CZGL.AliIoTClient.ConnectCode ConnectIoT(string[] SubTopic, [byte[] QOS = null], [ushort keepAlivePeriod = 60])

public System.Threading.Tasks.Task ConnectIoTAsync(string[] topics, [byte[] QOS = null], [ushort keepAlivePeriod = 60])

为便于快速理解，以下表格详细列出了参数说明与返回值含义：

每个主题都拥有独立的QoS属性，因此SubTopic数组与QOS数组的长度必须保持一致，且索引位置需一一对应。

QoS的含义简单明了：

• QOS = 0：最多一次（至多交付一次）
• QOS = 1：至少一次（保证至少到达一次）
• QOS = 2：只有一次（确保精确一次交付）

ConnectCode枚举完整反映了连接的各种状态，如下表所示：

使用示例：

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

2）断开连接

public bool ConnectIoTClose()

该方法会彻底释放AliIoTClientJson对象，而不仅仅是使设备离线。若需重新连接，必须重新实例化一个新对象。

调用示例：

client.ConnectIoT(topics, null, 60);

3）查看状态

若要判断客户端是否仍与服务器保持连接，可使用以下属性：

public bool isConnected { get; }

示例：

Console.WriteLine("是否与服务器保持连接：" + client.isConnected);