企业服务器与物联网平台通信

企业服务器与物联网平台通信
https://blog.csdn.net/weixin_44101331/article/details/86504614
目录
一,什么是服务端订阅
二,开发指南(.NET)
1,配置服务端订阅
2,接入 SDK
3,身份认证
4,设置消息接收接口
5,消息体格式
一,什么是服务端订阅
服务端可以直接订阅产品下配置的所有类型的消息。
目前,新版物联网平台通过HTTP/2通道进行消息流转。配置HTTP/2服务端订阅后,物联网平台会将消息通过HTTP/2通道推送至服务端。通过接入HTTP/2 SDK,企业服务器可以直接从物联网平台接收消息。HTTP/2 SDK提供身份认证、Topic订阅、消息发送和消息接收能力,并支持设备接入和云端接入能力。HTTP/2 SDK适用于物联网平台与企业服务器之间的大量消息流转,也支持设备与物联网平台之间的消息收发。
注:旧版物联网平台用户使用阿里云消息服务(MNS)进行消息流转,您可以将服务端订阅方式升级为HTTP/2方式。如果您继续使用在MNS这种方式,物联网平台将设备消息推送至MNS,服务端应用通过监听MNS队列接收设备消息。
二,开发指南(.NET)
介绍如何配置服务端订阅、接入HTTP/2 .NET版SDK、进行身份认证和设置消息接收接口。以下简单介绍服务端订阅的开发流程。有关SDK配置的具体信息,请参考Demo。
1,配置服务端订阅
登录物联网平台控制台。
左侧导航栏选择设备管理 > 产品。
在产品列表中,搜索到要配置服务端订阅的产品,并单击该产品对应的查看按钮,进入产品详情页。
单击服务端订阅 > 设置。
选择推送的消息类型。
设备上报消息:指产品下所有设备 Topic 列表中,具有发布权限的 Topic 中的消息。勾选后,可以通过 HTTP/2 SDK 接收这些消息。
设备状态变化通知:指一旦该产品下的设备状态变化时通知的消息,例如设备上线、下线的消息。设备状态消息的发送 Topic 为 /as/mqtt/status/YourProductKey/{YourProductKey}/{YourDeviceName}。勾选后,可以通过 HTTP/2 SDK 接收设备状态变化的通知消息。
2,接入 SDK
在工程中添加依赖包 iotx-as-http2-net-sdk.dll。
3,身份认证
使用服务端订阅功能,需要基于您的阿里云 AccessKey 进行身份认证并建立连接。
建立链接示例如下:
//阿里云accessKey:即您的账号的 AccessKey ID
string accessKey = “xxxxxxxxxxxxxxx”;
//阿里云accessSecret:即 AccessKey ID对应的 AccessKey Secret
string accessSecret = “xxxxxxxxxxxxxxx”;
//regionId:为您的物联网平台服务地域
string regionId = “cn-shanghai”;
//阿里云uid:您的账号 ID
string uid = “xxxxxxxxxxxxxxx”;
//domain
string domain = “.aliyuncs.com”;
//endpoint
string endpoint = “https://” + uid + “.iot-as-http2.” + regionId + domain;

//连接参数配置
Profile profile = new Profile();
profile.AccessKey = accessKey;
profile.AccessSecret = accessSecret;
profile.RegionId = regionId;
profile.Domain = domain;
profile.Url = endpoint;
//清除堆积消息
profile.CleanSession = true;
profile.GetAccessKeyAuthParams();

//构造客户端
IMessageClient client = new MessageClient(profile);

//连接HTTP2通道,并接收消息
client.DoConnection(new DefaultHttp2MessageCallback());

//指定topic回调
client.SetMessageListener("/KaTeX parse error: Expected 'EOF', got '#' at position 18: …ourProductKey}/#̲", new CustomHt…{YourProductKey}/#",messageCallback);用于设置回调。本示例中,设置为指定 Topic 回调。您可以设置为指定 Topic 回调,也可以设置为通用回调。
指定 Topic 回调
指定 Topic 回调的优先级高于通用回调。一条消息匹配到多个 Topic 时,按字典顺序优先调用,并且仅回调一次。
设置回调时,可以指定带通配符的 Topic,如 /YourProductKey/{YourProductKey}/{YourDeviceName}/#
示例:
client.SetMessageListener("/alEddfaXXXX/device1/#",messageCallback);
//当收到消息的Topic,如"/alEddfaXXXX/device1/update",匹配指定Topic时,会优先调用该回调
1
2
通用回调
未指定 Topic 回调的消息,则调用通用回调。
设置通用回调方法:
new DefaultHttp2MessageCallback()
1
5,设置回复 ACK。
对于 QOS>0 的消息,消费后需要回复 ACK。SDK 支持自动回复 ACK 和手动回复 ACK。默认为自动回复 ACK。本示例中未设置回复 ACK,则默认为自动回复。
自动回复 ACK:设置为自动回复 ACK 后,若 IHttp2MessageCallback.consume 的返回值为 ConsumeAction.CommitSuccess 则 SDK 会发送 ACK;返回 ConsumeAction.CommitFailure 或抛出异常,则不会返回 ACK。对于 QOS>0 且未回复 ACK 的消息,服务端会重新发送。
手动回复 ACK:通过ConsumeAction.CommitFailure设置手动回复 ACK。
设置为手动回复 ACK 后,需要调用MessageClient.DoAck()方法回复 ACK,参数为 topic、messageId和连接体。 这些参数可以在接收消息中获取到。
手动回复 ACK 的方法:
client.DoAck(connection, topic, messageId, delegate);
1
5,消息体格式
1,设备状态通知:
{
“status”:“online|offline”, //设备状态,online上线,offline离线
“productKey”:“12345565569”, //设备所属产品的唯一标识
“deviceName”:“deviceName1234”, //设备名称
“time”:“2018-08-31 15:32:28.205”, //发送通知的时间点
“utcTime”:“2018-08-31T07:32:28.205Z”, //发送通知的UTC时间点
“lastTime”:“2018-08-31 15:32:28.195”, //状态变更时最后一次通信时间
“utcLastTime”:“2018-08-31T07:32:28.195Z”, //状态变更时最后一次通信的UTC时间
“clientIp”:“123.123.123.123” //设备公网出口IP
}
说明 为避免消息时序紊乱造成影响,建议您根据lastTime来维护最终设备状态。
2,设备生命周期变更:
{
“action” : “create|delete|enable|disable”,
“iotId” : “4z819VQHk6VSLmmBJfrf00107ee201”,
“productKey” : “12345565569”,
“deviceName” : “deviceName1234”,
“deviceSecret” : “”,
“messageCreateTime”: 1510292739881
}

3,设备拓扑关系变更:
{
“action” : “add|remove|enable|disable”,
“gwIotId”: “4z819VQHk6VSLmmBJfrf00107ee200”,
“gwProductKey”: “1234556554”,
“gwDeviceName”: “deviceName1234”,
“devices”: [
{
“iotId”: “4z819VQHk6VSLmmBJfrf00107ee201”,
“productKey”: “12345565569”,
“deviceName”: “deviceName1234”
}
],
“messageCreateTime”: 1510292739881
}
4,网关发现子设备上报:
{
“gwIotId”:“4z819VQHk6VSLmmBJfrf00107ee200”,
“gwProductKey”:“1234556554”,
“gwDeviceName”:“deviceName1234”,
“devices”:[
{
“iotId”:“4z819VQHk6VSLmmBJfrf00107ee201”,
“productKey”:“12345565569”,
“deviceName”:“deviceName1234”
}
]
}
欢迎加入我们

展开阅读全文

没有更多推荐了,返回首页