使用 SendConnectorEvent API 傳送裝置事件

裝置啟動的事件概觀

雖然 SendConnectorEvent API 用於非同步回應 AWS.SendCommand和 AWS.DiscoverDevices操作，但它也用於通知受管整合任何裝置啟動的事件。裝置起始事件可以定義為裝置在沒有使用者起始命令的情況下產生的任何事件。這些裝置事件可能包括但不限於裝置狀態變更、動作偵測、電池電量等。您可以使用具有操作 DEVICE_EVENT 的 SendConnectorEvent API，將這些事件傳回至受管整合。

下節使用安裝在家中的智慧攝影機做為範例，進一步說明這些事件的工作流程：

裝置事件工作流程

1. 您的攝影機會偵測其產生傳送至資源伺服器的 事件的動作。

2. 您的資源伺服器會處理事件，並將其傳送至 C2C 連接器。

3. 連接器會將此事件轉譯為 AWS IoT Device Management DEVICE_EVENT 介面的受管整合。

4. 您的 C2C 連接器會使用操作設為 "DEVICE_EVENT" 的 SendConnectorEvent API，將此裝置事件傳送至受管整合。

5. 受管整合可識別相關客戶，並將此事件轉傳給客戶。

6. 客戶會收到此事件，並透過使用者識別符將其顯示給使用者。

如需 SendConnectorEvent API 操作的詳細資訊，請參閱《AWS IoT Device Management API 參考指南》SendConnectorEvent中的 受管整合。

裝置啟動的事件需求

以下是裝置啟動事件的一些需求。

• 您的 C2C 連接器資源應該能夠從資源伺服器接收非同步裝置事件

• 您的 C2C 連接器資源應該可以使用 AWS 帳戶 用於註冊 C2C 連接器的 AWS 憑證，透過 SigV4 呼叫 AWS IoT Device Management 服務 API 的受管整合。

下列範例示範透過 SendConnectorEvent API 傳送裝置來源事件的連接器：

AWS-API: /SendConnectorEvent
URI: POST /connector-event/{Your-Connector-Id}

{
   "UserId": "Your-End-User-ID",
   "Operation": "DEVICE_EVENT",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": None,
   "ConnectorDeviceId": "Your_Device_Id",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": "3"
                }
            ]
        }]
    }]
}

從下列範例中，我們看到以下內容：

• 這是來自 ID 等於 1 的裝置端點。

• 此事件相關的裝置功能，其叢集 ID 為 0x0202，與 Fan Control 事件叢集有關。

• 已變更的 屬性具有 0x000 的 ID，與叢集內的風扇模式列舉相關。它已更新為 值 3，與 High 值相關。

• 由於 connectorId 是雲端服務在建立時傳回的參數，因此 Connectors 必須使用 GetCloudConnector 進行查詢，並依 篩選lambdaARN。使用 Lambda.get_function_url_config API ARN 查詢 Lambda 自己的 。這可讓 在 lambda 中CloudConnectorId動態存取 ，而不是像先前一樣靜態設定。