实施 AWS.SendCommand 操作

该AWS.SendCommand操作允许托管集成 AWS IoT Device Management 将最终用户发起的命令通过 AWS 客户发送到您的资源服务器。您的资源服务器可能支持多种类型的设备，其中每种类型都有自己的响应模型。

命令执行是一个异步过程，其中托管集成 AWS IoT Device Management 向发送命令执行请求traceId，您的连接器将包含在 AWS IoT Device Management 通过 API 发送回托管集成的命令响应中SendConnectorEvent。的 Managed Integrations AWS IoT Device Management 期望资源服务器返回一个响应，确认已收到命令，但不一定表示该命令已执行。

设备命令执行工作流程

下图说明了命令执行流程，并举例说明了最终用户尝试打开房屋灯光的示例：

工作流程步骤

执行设备命令的 C2C 连接器要求

以下列表概述了 C2C 连接器的要求，以促进设备命令的成功执行。

命令执行过程

步骤 1：托管集成向连接器发送命令

根据授权类型，发送包含以下负载之一的 POST 请求：

OAuth 2.0 请求：

/Send-Command
{
     "header": {
          "auth": {                 
              "token": "ashriu32yr97feqy7afsaf",  
              "type": "OAuth2.0"
          }
     },
     "payload": {
          "operationName": "AWS.SendCommand",
          "operationVersion": "1.0",
          "connectorId": "Your-Connector-Id",
          "connectorDeviceId": "Your_Device_Id",
          "traceId": "traceId-3241u78123419",
          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3”
                  		}
                  }]
              }]
          }]
     }
  }

一般授权请求：

/Send-Command
{
     "header": {
          "auth": {
              "secretsManager": {
                  "arn": "string",
                  "versionId": "string"
              },
              "type": "GeneralAuthorization"
          }
     },
     "payload": {
          "operationName": "AWS.SendCommand",
          "operationVersion": "1.0",
          "connectorId": "Your-Connector-Id",
          "connectorDeviceId": "Your_Device_Id",
          "traceId": "traceId-3241u78123419",
          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3"
                  		}
                  }]
              }]
          }]
     }
}

步骤 2：C2C 连接器 ACK 命令

{
     "header":{
          "responseCode":200
     },
     "payload":{
          "responseMessage": "Successfully received send-command request for connector 'Your-Connector-Id' and connector-device-id 'Your_Device_Id'" 
     }
  }

步骤 3：连接器发送设备命令响应事件

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

{
   "UserId": "End-User-Id",
   "Operation": "DEVICE_COMMAND_RESPONSE",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": “Example message”,
   "ConnectorDeviceId": "Your_Device_Id",
   "TraceId": "traceId-3241u78123419",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": “3”
                }
            ],
            "commands": [
                "0xff01": 
                {
                    "0x0000": "3”
                }            
 		]
        }]
    }
}

解释 AWS.SendCommand 请求中包含的事项 “端点”

托管集成将使用设备发现期间报告的设备功能来确定设备可以接受哪些命令。每个设备功能都是通过 AWS 实现物质数据模型进行建模的；因此，所有传入的命令都将从给定集群中的 “commands” 字段派生。您的连接器负责解析 “端点” 字段，确定相应的 Matter 命令，然后对其进行翻译，以便正确的命令到达设备。通常，这意味着将 Matter 数据模型转换为相关的 API 请求。

执行命令后，您的连接器将确定由物质数据模型的 AWS 实现定义的哪些 “属性” 因此发生了变化。然后，这些更改将通过 API 发送的 API DEVICE_COMMAND_RESPONSE 事件报告给 AWS IoT Device Management 的托管集成。SendConnectorEvent

考虑以下示例负载中包含的 “端点” 字段：AWS.SendCommand

          "endpoints": [{
              "id": "1",    
              "clusters": [{
                  "id": "0x0202",
                  "commands": [{
                      "0xff01": 
                          {
                              "0x0000": "3”
                  		}
                  }]
              }]
          }]

Managed Integrations 定义了两种 “自定义” 命令类型，这些类型不是由物质数据模型的 AWS 实现严格定义的： ReadState 和 UpdateState 命令。要获取和设置 Matter 定义的集群属性，托管集成将向您的连接器发送一个AWS.SendCommand请求，其中包含与 UpdateState (id: 0xff01) 或 ReadState (id: 0xff02) 相关的命令 ID，以及必须更新或读取的相应属性参数。对于设置为可变（可更新）或可检索（可读取）的属性，可以为任何设备类型调用这些命令，这些属性可以从相应的 Matter 数据模型 AWS 实现中调用。