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

# AWS IoT Device Shadow 库
<a name="freertos-lib-cloud-shadows"></a>

**注意**  <a name="out-of-date-message"></a>
此页面上的内容可能不是最新的。有关最新更新，请参阅 [FreeRTOS.org 库页面](https://www.freertos.org/Documentation/03-Libraries/01-Library-overview/01-All-libraries)。

## 简介
<a name="freertos-shadow-introduction"></a>

您可以使用 AWS IoT Device Shadow 库来存储和检索每台已注册设备的当前状态（*影子*）。设备影子是设备的永久性虚拟表示形式，即使设备处于离线状态，您也可以在 Web 应用程序中与之交互。设备状态以影子的形式进行捕获，并保存在 [JSON](https://www.json.org/) 文档中。您可以通过 MQTT 或 HTTP 向 AWS IoT Device Shadow 服务发送命令，以便查询最新的已知设备状态或更改状态。每个设备影子都由相应*事物*的名称唯一标识，该名称表示 AWS 云上的特定设备或逻辑实体。有关更多信息，请参阅[使用 AWS IoT 管理事物](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html)。有关影子的更多详细信息，请参阅 [AWS IoT 文档](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html)。

除了标准 C 库之外，AWS IoT Device Shadow 库不依赖于任何其他库。该库没有平台依赖关系，例如线程或同步。它可以与任何 MQTT 库以及任何 JSON 一起使用。

该库可免费使用，并根据 [MIT 开源许可证](https://freertos.org/a00114.html)分发。


****  

| AWS IoT Device Shadow 的代码大小（使用 GCC for ARM Cortex-M 生成的示例） | 文件 | 使用 -O1 优化 | 使用 -Os 优化 | 
| --- | --- | --- | --- | 
| shadow.c | 1.2K | 0.9K | 
| 估计总数 | 1.2K | 0.9K |