在應用程式和服務中使用影子 - AWS IoT Core
在連線至 時初始化應用程式或服務AWS IoT應用程式或服務連線到 時，處理狀態會變更AWS IoT偵測裝置是否已連線

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

在應用程式和服務中使用影子

本節說明應用程式或服務如何與 AWS IoTDevice Shadow 服務互動。此範例假設應用程式或服務只透過影子與影子與該裝置互動。此範例不包含任何管理動作，例如建立或刪除影子。

此範例使用 AWS IoTDevice Shadow 服務的 REST API 與陰影互動。與用於 在裝置中使用影子 中的範例 (使用發佈/訂閱通訊模型) 不同，此範例使用 REST API 的請求/回應通訊模型。這表示應用程式或服務必須先提出請求，才能接收來自 的回應AWS IoT。不過，此模型的缺點是它不支援通知。如果您的應用程式或服務需要及時通知裝置狀態變更，請考慮透過 WSS 通訊協定支援發佈/訂閱通訊模型的 MQTT 或 MQTT，如中所述 在裝置中使用影子。

重要

請確定您的應用程式或服務對影子的使用與裝置中的對應實作一致，並支援這些功能。例如，請考慮如何建立、更新和刪除影子，以及如何在裝置和存取影子的應用程式或服務中處理更新。您的設計應該清楚指定裝置狀態的更新和報告方式，以及您的應用程式和服務如何與裝置及其影子互動。

REST API 的已命名影子 URL 是：

https://endpoint/things/thingName/shadow?name=shadowName

和一個未命名的影子：

https://endpoint/things/thingName/shadow

其中：

端點

CLI 命令傳回的端點：

aws iot describe-endpoint --endpoint-type IOT:Data-ATS
thingName

影子所屬物件物件的名稱

shadowName

已命名影子的名稱。此參數不會與未命名影子搭配使用。

在連線至 時初始化應用程式或服務AWS IoT

當應用程式第一次連線到 時AWS IoT，應傳送 HTTP GET 請求至其使用的影子 URLs，以取得其使用的影子目前狀態。這可讓它將應用程式或服務同步到影子。

應用程式或服務連線到 時，處理狀態會變更AWS IoT

當應用程式或服務連線到 時AWS IoT，它可以在其使用的影子 URLs上傳送 HTTP GET 請求，以定期查詢目前狀態。

當使用者與應用程式或服務互動以變更裝置狀態時，應用程式或服務可以將 HTTP POST 請求傳送至用來更新 desired 影子狀態的影子 URL。此請求會傳回已接受的變更，但是您可能必須透過提出 HTTP GET 請求來輪詢影子，直到裝置已更新其新狀態的影子。

偵測裝置是否已連線

若要判斷裝置目前是否已連線，請在影子文件中包含 connected 屬性，並使用 MQTT Last Will 和 Testament (LWT) 訊息以將 connected 屬性設為 false (若裝置因錯誤而中斷連線)。

注意

AWS IoTDevice Shadow 服務會忽略傳送至AWS IoT預留主題 （開頭為 $ 的主題） 的 MQTT LWT 訊息。不過，它們是由訂閱的用戶端和AWS IoT規則引擎處理，因此您需要建立傳送至非預留主題的 LWT 訊息，以及將 MQTT LWT 訊息作為影子更新訊息重新發佈至影子的預留更新主題 的規則ShadowTopicPrefix/update。

傳送 LWT 訊息 Device Shadow 服務

  1. 建立重新發佈保留主題上的 MQTT LWT 訊息的規則。下列範例規則會接聽有關 my/things/myLightBulb/update 主題的訊息，並將其重新發佈至 $aws/things/myLightBulb/shadow/update。

    {
    "rule": {
    "ruleDisabled": false,
    "sql": "SELECT * FROM 'my/things/myLightBulb/update'",
    "description": "Turn my/things/ into $aws/things/",
    "actions": [
        {
        "republish": {
            "topic": "$$aws/things/myLightBulb/shadow/update",
            "roleArn": "arn:aws:iam:123456789012:role/aws_iot_republish"
            }
        }
     ]
   }
}

  2. 當裝置連線到 時AWS IoT，它會將 LWT 訊息註冊到未保留的主題，以便重新發佈規則進行辨識。在此範例中，該主題是 my/things/myLightBulb/update，它會將連線的內容設定為 false。

    {
    "state": {        
        "reported": {
            "connected":"false"
        }
    }
}

  3. 連線後，裝置會在其影子更新主題上發佈訊息 $aws/things/myLightBulb/shadow/update，並報告其目前狀態，其中包括將其 connected 屬性設定為 true。

    {
     "state": {        
        "reported": {
            "connected":"true"
        }
    }
}

  4. 在裝置正常中斷連線之前，它會發佈其影子更新主題的訊息 $aws/things/myLightBulb/shadow/update，以報告其最新狀態，其中包括將其 connected 屬性設定為 false。

    {
    "state": {        
        "reported": {
            "connected":"false"
        }
    }
}

  5. 如果裝置因錯誤而中斷連線，AWS IoT訊息中介裝置會代表裝置發佈裝置的 LWT 訊息。重新發佈規則會偵測到此訊息，並發佈影子更新訊息，以更新 Device Shadow 的 connected 屬性。

注意

由於中斷連線處理的非同步性質，LWT 訊息不保證在重新連線期間會依序分派。我們建議您使用生命週期事件來改善連線狀態偵測的準確性，因為這些事件提供屬性來管理out-of-order的事件。