action.devices.EXECUTE

此 intent 会发送要在智能家居设备上执行的命令。

您的执行方式应处理每个命令，将其传输到相应设备，并在 EXECUTE 响应中返回新状态。

一个 EXECUTE intent 可以使用多个命令定位多个设备。例如，一个被触发的 intent 可能会为一组灯设置亮度和颜色，或将多个灯设置为不同的颜色。

如需了解详情，请参阅查询和执行。

请求格式

字段	类型	说明
`requestId`	String	必填。请求的 ID。
`inputs`	数组	必填。与 intent 请求匹配的输入的列表。
`[item, ...]`	对象	与 intent 请求关联的类型和载荷。
`intent`		必填。（常量值：`"action.devices.EXECUTE"`） intent 请求类型。
`payload`	对象	必填。 EXECUTE 请求载荷。
`commands`	数组	必填。设备目标和命令对的列表。
`[item, ...]`	对象	要在已连接的设备目标上执行的一组命令。
`devices`	数组	必填。目标设备列表。
`[item, ...]`	对象	要执行的设备目标。
`id`	String	必填。设备 ID，应与 SYNC 中提供的 ID 一致。
`customData`	对象	如果在 SYNC 中提供了不透明的 customData 对象，系统会将其发送到此处。
`execution`	数组	必填。要在目标设备上执行的命令的列表。
`[item, ...]`	对象	设备命令。
`command`	String	必填。要执行的命令，通常附带参数。
`params`	对象	与每个命令的参数保持一致。

示例

EXECUTE intent 请求

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123",
                "customData": {
                  "fooValue": 74,
                  "barValue": true,
                  "bazValue": "sheepdip"
                }
              },
              {
                "id": "456",
                "customData": {
                  "fooValue": 36,
                  "barValue": false,
                  "bazValue": "moarsheep"
                }
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

响应格式

字段	类型	说明
`requestId`	String	必填。相应请求的 ID。
`payload`	对象	必填。 intent 响应载荷。
`errorCode`	String	整个事务的错误代码，用于表示授权失败和开发者系统不可用。对于单个设备错误，请使用 device 对象中的 errorCode。
`debugString`	String	详细的响应错误，绝不会向用户显示，但可能会在开发期间记录或使用。
`commands`	数组	每个对象都包含一个或多个包含响应详细信息的设备。请注意，这些数据的组合方式可能与请求中不同。例如，请求可能会开启 7 个灯，其中 3 个灯成功开启，4 个灯开启失败，因此响应中会包含两个组。
`[item, ...]`	对象	设备执行结果。
`ids`	数组	必填。与此状态对应的设备 ID 列表。
`[item, ...]`	String	设备 ID。
`status`	String	必填。执行操作的结果。支持的值： `SUCCESS` 确认该命令是否成功。 `PENDING` 命令已加入队列，但预计会成功。 `OFFLINE` 目标设备处于离线状态或无法访问。 `EXCEPTIONS` 相应指令存在问题或提醒。该命令可能会成功或失败。当您想要发送有关其他已连接设备的更多信息时，通常会设置此状态类型。 `ERROR` 目标设备无法执行该命令。
`states`	对象	与每个 trait 架构参考文档中所述的每个 trait 状态保持一致。以下是执行后的状态（如果有）。
`online`	布尔值	指示设备是否处于在线（即可访问）状态。
`errorCode`	String	根据预设错误代码（将映射到向用户显示的错误）扩展 ERROR 状态（如有必要）。
`debugString`	String	详细的命令级错误，绝不会向用户显示，但可能会在开发期间记录或使用。

示例

EXECUTE intent 响应

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      },
      {
        "ids": [
          "456"
        ],
        "status": "ERROR",
        "errorCode": "deviceTurnedOff"
      }
    ]
  }
}