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

模擬 Device Shadow 服務通訊

本主題示範如何將 Device Shadow 服務如何作為中繼點，並允許裝置和應用程式使用影子來更新、儲存和擷取裝置的狀態。

若要示範本主題中描述的互動，並進一步探索，您將需要 AWS 帳戶 和 系統，以便在其中執行 AWS CLI。如果您沒有這些項目，您仍然可以在程式碼範例中看到互動。

在此範例中， AWS IoT 主控台代表裝置。 AWS CLI 代表透過影子存取裝置的應用程式或服務。 AWS CLI 介面與應用程式可能用來與 通訊API的 非常相似 AWS IoT。此範例中的裝置是智慧型燈泡，應用程式會顯示燈泡的狀態，而且可以變更燈泡的狀態。

準備模擬

以下程序會開啟模擬裝置的 AWS IoT 主控台，以及模擬應用程式的命令列視窗來初始化模擬。

您應該開啟兩個視窗：一個在測試頁面上具有 AWS IoT 主控台，另一個在命令列提示字元。

初始化裝置

在此模擬中，我們將使用名為 的物件mySimulatedThing，及其名為 simShadow1 的影子。

建立物件及其 IoT 政策

如要建立物件物件，請於 AWS IoT 主控台中：

為物件建立已命名的影子

您可以向主題 $aws/things/mySimulatedThing/shadow/name/simShadow1/update 發佈更新請求來為物件建立已命名的影子，如下方所述。

或者，若要建立具名影子：

訂閱並發佈至預留MQTT主題

在 主控台中，訂閱預留MQTT陰影主題。這些主題是對 get、update 和 delete 動作的回應，以便您的裝置在發佈動作之後就可以接收回應。

若要發佈至MQTT用戶端中的MQTT主題

在裝置自行初始化並訂閱回應主題之後，它會查詢所支援的影子。此模擬僅支援一個影子，該影子支援名為 、mySimulatedThing名為 、simShadow1 的物件。

若您在主題中收到一則訊息：

從應用程式傳送更新

本節使用 AWS CLI 示範應用程式如何與影子互動。

若要使用 取得陰影的目前狀態 AWS CLI

在命令列輸入此命令：

aws iot-data get-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 /dev/stdout

在 Windows 平台上，您可使用 con，而非 /dev/stdout。

aws iot-data get-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 con

因為影子已存在，而且已由裝置初始化以反映其目前狀態，所以它會傳回下列的影子文件。

{
  "state": {
    "reported": {
      "ID": "SmartLamp21",
      "ColorRGB": [
        128,
        128,
        128
      ]
    }
  },
  "metadata": {
    "reported": {
      "ID": {
        "timestamp": 1591140517
      },
      "ColorRGB": [
        {
          "timestamp": 1591140517
        },
        {
          "timestamp": 1591140517
        },
        {
          "timestamp": 1591140517
        }
      ]
    }
  },
  "version": 3,
  "timestamp": 1591141111
}

應用程式可以使用此回應來初始化對其裝置狀態的表示法。

如果應用程式更新狀態，例如當使用者將智慧型燈泡的顏色變更為黃色時，應用程式會傳送 update-thing-shadow 命令。此命令對應至 UpdateThingShadow REST API。

從應用程式更新影子

在命令列輸入此命令：

AWS CLI v2.x

aws iot-data update-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 \
    --cli-binary-format raw-in-base64-out \
    --payload '{"state":{"desired":{"ColorRGB":[255,255,0]}},"clientToken":"21b21b21-bfd2-4279-8c65-e2f697ff4fab"}' /dev/stdout

AWS CLI v1.x

aws iot-data update-thing-shadow --thing-name mySimulatedThing --shadow-name simShadow1 \
    --payload '{"state":{"desired":{"ColorRGB":[255,255,0]}},"clientToken":"21b21b21-bfd2-4279-8c65-e2f697ff4fab"}' /dev/stdout

如果成功，這個命令應該會傳回下列影子文件。

{
  "state": {
    "desired": {
      "ColorRGB": [
        255,
        255,
        0
      ]
    }
  },
  "metadata": {
    "desired": {
      "ColorRGB": [
        {
          "timestamp": 1591141596
        },
        {
          "timestamp": 1591141596
        },
        {
          "timestamp": 1591141596
        }
      ]
    }
  },
  "version": 4,
  "timestamp": 1591141596,
  "clientToken": "21b21b21-bfd2-4279-8c65-e2f697ff4fab"
}

回應裝置中的更新

返回 AWS 主控台中的MQTT用戶端時，您應該會看到 AWS IoT 發佈的訊息，以反映上一節中發佈的更新命令。

在MQTT用戶端中檢視更新訊息

在MQTT用戶端 中，選擇訂閱欄中的 $aws/things/mySimulatedThing/shadow/name/simShadow1/update/delta。如果主題名稱被截斷，您可以暫停以查看完整主題。在本主題的主題記錄中，您應會看到類似此訊息的 /delta 訊息。

{
  "version": 4,
  "timestamp": 1591141596,
  "state": {
    "ColorRGB": [
      255,
      255,
      0
    ]
  },
  "metadata": {
    "ColorRGB": [
      {
        "timestamp": 1591141596
      },
      {
        "timestamp": 1591141596
      },
      {
        "timestamp": 1591141596
      }
    ]
  },
  "clientToken": "21b21b21-bfd2-4279-8c65-e2f697ff4fab"
}

您的裝置會處理此訊息的內容，以將裝置狀態設定為符合訊息中的 desired 狀態。

裝置更新狀態以符合訊息中desired狀態後，必須透過 AWS IoT 發佈更新訊息，將新的報告狀態傳回 。此程序會在MQTT用戶端 中模擬這一點。

成功更新報告的裝置狀態也會導致 AWS IoT 將訊息中影子狀態的完整描述傳送至主題，例如由裝置在上述程序中執行的影子更新所導致的此訊息內文。

{
  "previous": {
    "state": {
      "desired": {
        "ColorRGB": [
          255,
          255,
          0
        ]
      },
      "reported": {
        "ID": "SmartLamp21",
        "ColorRGB": [
          128,
          128,
          128
        ]
      }
    },
    "metadata": {
      "desired": {
        "ColorRGB": [
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          }
        ]
      },
      "reported": {
        "ID": {
          "timestamp": 1591140517
        },
        "ColorRGB": [
          {
            "timestamp": 1591140517
          },
          {
            "timestamp": 1591140517
          },
          {
            "timestamp": 1591140517
          }
        ]
      }
    },
    "version": 4
  },
  "current": {
    "state": {
      "desired": {
        "ColorRGB": [
          255,
          255,
          0
        ]
      },
      "reported": {
        "ID": "SmartLamp21",
        "ColorRGB": [
          255,
          255,
          0
        ]
      }
    },
    "metadata": {
      "desired": {
        "ColorRGB": [
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          },
          {
            "timestamp": 1591141596
          }
        ]
      },
      "reported": {
        "ID": {
          "timestamp": 1591140517
        },
        "ColorRGB": [
          {
            "timestamp": 1591142747
          },
          {
            "timestamp": 1591142747
          },
          {
            "timestamp": 1591142747
          }
        ]
      }
    },
    "version": 5
  },
  "timestamp": 1591142747,
  "clientToken": "a4dc2227-9213-4c6a-a6a5-053304f60258"
}

觀察應用程式中的更新

應用程式現在可以查詢裝置報告的目前狀態的影子。

超越模擬

試驗 AWS CLI (代表應用程式) 與主控台 (代表裝置) 之間的互動，以建立 IoT 解決方案的模型。