本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS IoT 裝置影子程式庫
<a name="freertos-lib-cloud-shadows"></a>

**注意**  <a name="out-of-date-message"></a>
此頁面上的內容可能不是up-to-date。如需最新更新，請參閱 [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)。

 AWS IoT Device Shadow 程式庫對標準 C 程式庫以外的其他程式庫沒有相依性。它也沒有任何平台相依性，例如執行緒或同步。它可以與任何 MQTT 程式庫和任何 JSON 程式庫搭配使用。

此程式庫可以自由使用，並根據 [MIT 開放原始碼授權](https://freertos.org/a00114.html)進行分發。


****  
<a name="shadow-memory-estimate"></a>
<table>
<thead>
  <tr><th colspan="3"> AWS IoT Device Shadow 的程式碼大小 （使用 GCC for ARM Cortex-M 產生的範例）</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>