本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 影子
<a name="device-advisor-tests-shadow"></a>

使用这些测试来验证您的被测设备是否正确使用 AWS IoT 了 Device Shadow 服务。请参阅[AWS IoT Device Shadow 服务](iot-device-shadows.md)了解更多信息。如果在测试套件中配置了这些测试使用案例，则在启动套件运行时需要提供一个事物。

 WebSocket目前不支持 **MQTT** 版本。

## 发布
<a name="publish"></a>

***“设备连接后发布状态（快乐使用案例）”***  
验证设备连接后能否发布其状态 AWS IoT Core  
*API 测试用例定义：*  
`EXECUTION_TIMEOUT` 的默认值为 5 分钟。我们建议将超时值设置为 2 分钟。

```
"tests":[
   {
      "name":"my_shadow_publish_reported_state",
      "configuration": {
         // optional:
         "EXECUTION_TIMEOUT":"300", // in seconds
         "SHADOW_NAME": "SHADOW_NAME",
         "REPORTED_STATE": {
            "STATE_ATTRIBUTE": "STATE_VALUE"
         }
      },
      "test":{
         "id":"Shadow_Publish_Reported_State",
         "version":"0.0.0"
      }
   }
]
```
`REPORTED_STATE` 可以在设备连接后对其确切影子状态进行额外验证。默认情况下，此测试使用案例会验证您的设备发布状态。  
如果未提供 `SHADOW_NAME`，则测试使用案例将默认查找发布到 Unnamed（经典）影子类型的主题前缀的消息。如果您的设备使用命名的影子类型，请提供影子名称。请参阅[在设备中使用影子](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-comms-device.html)，了解更多信息。

## 更新
<a name="update"></a>

***“设备更新报告状态为理想状态（快乐使用案例）”***  
验证设备是否读取所有收到的更新消息，并同步设备的状态以与所需的状态属性匹配。您的设备应在同步后发布其最新报告状态。如果您的设备在运行测试之前已存在影子，请确保为测试使用案例配置的所需状态与现有报告状态不匹配。您可以通过查看 Shadow 文档中的**ClientToken**字段来识别 Device Advisor 发送的 Shadow 更新消息`DeviceAdvisorShadowTestCaseSetup`。  
*API 测试用例定义：*  
`EXECUTION_TIMEOUT` 的默认值为 5 分钟。我们建议将超时值设置为 2 分钟。

```
"tests":[
   {
      "name":"my_shadow_update_reported_state",
      "configuration": {
         "DESIRED_STATE": {
            "STATE_ATTRIBUTE": "STATE_VALUE"
         },
         // optional:
         "EXECUTION_TIMEOUT":"300", // in seconds
         "SHADOW_NAME": "SHADOW_NAME"
      },
      "test":{
         "id":"Shadow_Update_Reported_State",
         "version":"0.0.0"
      }
   }
]
```
`DESIRED_STATE` 应具有至少一个属性和关联的值。  
如果未提供 `SHADOW_NAME`，则测试使用案例将默认查找发布到 Unnamed（经典）影子类型的主题前缀的消息。如果您的设备使用命名的影子类型，请提供影子名称。请参阅[在设备中使用影子](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-comms-device.html)，了解更多信息。