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

# Amazon 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>

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

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

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


****  
<a name="shadow-memory-estimate"></a>
<table>
<thead>
  <tr><th colspan="3">Dev Amazon IoT ice Shadow 的代码大小（使用适用于 ARM Cortex-M 的 GCC 生成的示例）</th></tr>
  <tr><th>文件</th><th>使用 -O1 优化</th><th>使用 -Os 优化</th></tr>
</thead>
<tbody>
  <tr><td>shadow.c</td><td>1.2K</td><td>0.9K</td></tr>
  <tr><td>估计总数</td><td>1.2K</td><td>0.9K</td></tr>
</tbody>
</table>