Edge 上的 EMQX 代理的消息有效载荷格式 Amazon IoT SiteWise - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Edge 上的 EMQX 代理的消息有效载荷格式 Amazon IoT SiteWise

要让 IoT SiteWise 发布者组件使用来自外部应用程序的数据并将其发布到 Amazon IoT SiteWise 云端,发送到代理的有效负载必须满足特定要求。

了解有效载荷格式是 MQTT 与 Amazon IoT SiteWise Edge 成功通信的关键。虽然连接设置过程将在后面的章节中介绍,但我们将首先介绍有效负载要求,以帮助您规划实施。

MQTT 主题要求

对 MQTT 主题结构没有限制,包括使用的关卡数量或字符数。但是,我们建议主题与有效载荷中的propertyAlias字段相匹配。

例 属性别名示例

如果 MQTT 主题是site1/line1/compressor1/temperature,请确保propertyAlias匹配。

{ "assetId": "compressor_asset_01", "propertyAlias": "site1/line1/compressor1/temperature", "propertyId": "temperature_sensor_01", "propertyValues": [ { "quality": "GOOD", "timestamp": { "offsetInNanos": 0, "timeInSeconds": 1683000000 }, "value": { "doubleValue": 23.5 } } ] }

JSON 负载结构

MQTT 消息负载以 JSON 编写,并遵循 Amazon IoT SiteWise API 参考中定义的PutAssetPropertyValueEntry消息格式。

{ "assetId": "string", "propertyAlias": "string", "propertyId": "string", "propertyValues": [ { "quality": "string", "timestamp": { "offsetInNanos": number, "timeInSeconds": number }, "value": { "booleanValue": boolean, "doubleValue": number, "integerValue": number, "stringValue": "string" } } ] }
注意

要使消息被视为有效,只能满足以下条件之一:

  • propertyAlias已设置,或者

  • assetIdpropertyId都设置好了

PutAssetPropertyValueEntry有一个在此上下文中不是必填的entryId字段。