本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
与客户端设备影子进行交互并进行同步
您可以使用阴影管理器组件来管理本地阴影,包括客户端设备阴影。您可以使用影子管理器执行以下操作:
-
在 Greengrass 组件中与客户端设备阴影进行交互。
-
将客户端设备阴影与同步AWS IoT Core。
注意
默认情况下,阴影管理器组件不与AWS IoT Core阴影同步。您必须配置影子管理器组件以指定要同步的客户端设备影子。
先决条件
要与客户端设备影子交互并与之同步客户端设备影子AWS IoT Core,核心设备必须满足以下要求:
-
除了支持客户端设备的 Greengrass 组件外,核心设备还必须运行以下组件:
-
Greengrass nucleus v2.6.0 或更高版本
-
影子管理器 v2.2.0 或更高版本
-
MQTT bridge v2.0 或更高版本
-
启用影子管理器与客户端设备通信
默认情况下,影子管理器组件不管理客户端设备影子。要启用此功能,您必须在客户端设备和影子管理器组件之间中继 MQTT 消息。客户端设备使用 MQTT 消息来接收和发送设备影子更新。影子管理器组件订阅本地 Greengrass 发布/订阅接口,因此您可以将 MQTT 桥接组件配置为在设备影子主题上中继 MQTT 消息。
MQTT bridge 组件使用主题映射列表,每个主题映射都指定消息源和消息目的地。要使影子管理器组件能够管理客户端设备影子,请部署 MQTT 桥接组件,并为客户端设备影子指定影子主题。您必须将网桥配置为在本地 MQTT 和本地发布/订阅之间双向中继消息。
要将 MQTT 桥接组件部署到一台或一组核心设备,请创建包含该aws.greengrass.clientdevices.mqtt.Bridge组件的部署。在部署的 MQTT 网桥组件配置中指定主题映射。mqttTopicMapping
使用以下示例配置 MQTT 网桥组件,以启用客户端设备与影子管理器组件之间的通信。
注意
您可以在AWS IoT Greengrass控制台中使用这些配置示例。如果您使用 AWS IoT Greengrass API,则merge
配置更新需要序列化的 JSON 对象,因此必须将以下 JSON 对象序列化为字符串。有关更多信息,请参阅 更新组件配置。
例 示例:管理所有客户端设备影子
以下 MQTT 桥接配置示例使影子管理器能够管理所有客户端设备的所有阴影。
{ "mqttTopicMapping": { "ShadowsLocalMqttToPubsub": { "topic": "$aws/things/+/shadow/#", "source": "LocalMqtt", "target": "Pubsub" }, "ShadowsPubsubToLocalMqtt": { "topic": "$aws/things/+/shadow/#", "source": "Pubsub", "target": "LocalMqtt" } } }
例 示例:管理客户端设备的阴影
以下 MQTT 桥接配置示例使影子管理器能够管理名MyClientDevice
为的客户端设备的所有阴影。
{ "mqttTopicMapping": { "ShadowsLocalMqttToPubsub": { "topic": "$aws/things/MyClientDevice/shadow/#", "source": "LocalMqtt", "target": "Pubsub" }, "ShadowsPubsubToLocalMqtt": { "topic": "$aws/things/MyClientDevice/shadow/#", "source": "Pubsub", "target": "LocalMqtt" } } }
例 示例:管理所有客户端设备的已命名影子
以下 MQTT 网桥配置示例使影子管理器能够管理DeviceConfiguration
为所有客户端设备命名的影子。
{ "mqttTopicMapping": { "ShadowsLocalMqttToPubsub": { "topic": "$aws/things/+/shadow/name/DeviceConfiguration/#", "source": "LocalMqtt", "target": "Pubsub" }, "ShadowsPubsubToLocalMqtt": { "topic": "$aws/things/+/shadow/name/DeviceConfiguration/#", "source": "Pubsub", "target": "LocalMqtt" } } }
例 示例:管理所有客户端设备的未命名阴影
以下 MQTT 桥接配置示例使影子管理器能够管理所有客户端设备的未命名阴影,但未命名的阴影。
{ "mqttTopicMapping": { "DeleteShadowLocalMqttToPubsub": { "topic": "$aws/things/+/shadow/delete", "source": "LocalMqtt", "target": "Pubsub" }, "DeleteShadowPubsubToLocalMqtt": { "topic": "$aws/things/+/shadow/delete/#", "source": "Pubsub", "target": "LocalMqtt" }, "GetShadowLocalMqttToPubsub": { "topic": "$aws/things/+/shadow/get", "source": "LocalMqtt", "target": "Pubsub" }, "GetShadowPubsubToLocalMqtt": { "topic": "$aws/things/+/shadow/get/#", "source": "Pubsub", "target": "LocalMqtt" }, "UpdateShadowLocalMqttToPubsub": { "topic": "$aws/things/+/shadow/update", "source": "LocalMqtt", "target": "Pubsub" }, "UpdateShadowPubsubToLocalMqtt": { "topic": "$aws/things/+/shadow/update/#", "source": "Pubsub", "target": "LocalMqtt" } } }
与组件中的客户端设备阴影交互
您可以开发使用本地影子服务读取和修改客户端设备的本地影子文档的自定义组件。有关更多信息,请参阅 与组件中的阴影交互。
将客户端设备阴影与同步 AWS IoT Core
您可以将影子管理器组件配置为与本地客户端设备影子状态同步AWS IoT Core。有关更多信息,请参阅 将本地设备阴影与同步 AWS IoT Core。