action.devices.EXECUTE

Este intent envía comandos para ejecutar en dispositivos de casa inteligente.

La entrega debe procesar cada comando, transmitirlo al dispositivo correspondiente y mostrar el estado nuevo en la respuesta EXECUTE.

Un solo intent EXECUTE puede orientarse a varios dispositivos con varios comandos. Por ejemplo, un intent activado puede establecer el brillo y el color en un conjunto de luces o puede establecer varias luces con un color diferente.

Para obtener más detalles, consulta Cómo consultar y ejecutar.

Formato de solicitud

Campos	Tipo	Descripción
`requestId`	String	Obligatorio. Es el ID de la solicitud.
`inputs`	Matriz	Obligatorio. Es la lista de entradas que coinciden con la solicitud de intent.
`[item, ...]`	Objeto	Es el tipo y la carga útil asociados con la solicitud de intent.
`intent`		Obligatorio. (valor constante: `"action.devices.EXECUTE"`). Tipo de solicitud de intent.
`payload`	Objeto	Obligatorio. Carga útil de la solicitud EXECUTE.
`commands`	Matriz	Obligatorio. Es una lista de pares de comandos y destinos de dispositivos.
`[item, ...]`	Objeto	Es un conjunto de comandos para ejecutar en los destinos de dispositivos conectados.
`devices`	Matriz	Obligatorio. Es la lista de dispositivos de destino.
`[item, ...]`	Objeto	Es el dispositivo de destino que se ejecutará.
`id`	String	Obligatorio. ID de dispositivo, según el ID proporcionado en SYNC.
`customData`	Objeto	Si el objeto customData opaco se proporciona en SYNC, se envía aquí.
`execution`	Matriz	Obligatorio. Es una lista de comandos para ejecutar en los dispositivos de destino.
`[item, ...]`	Objeto	Comando del dispositivo.
`command`	String	Obligatorio. Es el comando que se ejecutará, por lo general, con parámetros adicionales.
`params`	Objeto	Se alinean con los parámetros de cada comando.

Ejemplos

Solicitud de intent EXECUTE

{
  "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
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Formato de respuesta

Campos	Tipo	Descripción
`requestId`	String	Obligatorio. Es el ID de la solicitud correspondiente.
`payload`	Objeto	Obligatorio. Carga útil de la respuesta del intent.
`errorCode`	String	Es un código de error para toda la transacción por fallas de autenticación y falta de disponibilidad del sistema del desarrollador. Para errores de dispositivos individuales, usa errorCode dentro del objeto device.
`debugString`	String	Es un error de respuesta detallado que nunca se presentará a los usuarios, pero que se puede registrar o usar durante el desarrollo.
`commands`	Matriz	Cada objeto contiene uno o más dispositivos con detalles de la respuesta. Nota: Es posible que no se agrupen de la misma manera que en la solicitud. Por ejemplo, la solicitud podría encender 7 luces, con 3 que se encienden correctamente y 4 que fallan, por lo que habría dos grupos en la respuesta.
`[item, ...]`	Objeto	Es el resultado de la ejecución del dispositivo.
`ids`	Matriz	Obligatorio. Es la lista de IDs de dispositivos correspondientes a este estado.
`[item, ...]`	String	ID de dispositivo
`status`	String	Obligatorio. Es el resultado de la operación de ejecución. Valores admitidos: `SUCCESS` Confirma que el comando se ejecutó correctamente. `PENDING` El comando está en cola, pero se espera que se realice correctamente. `OFFLINE` El dispositivo de destino está sin conexión o no se puede acceder a él. `EXCEPTIONS` Hay un problema o una alerta asociados con un comando. El comando podría tener éxito o fallar. Por lo general, este tipo de estado se establece cuando quieres enviar información adicional sobre otro dispositivo conectado. `ERROR` El dispositivo de destino no puede realizar el comando.
`states`	Objeto	Se alinean con los estados por rasgo que se describen en cada referencia del esquema de rasgo. Estos son los estados después de la ejecución, si están disponibles.
`online`	Booleano	Indica si el dispositivo está en línea (es decir, si se puede acceder a él) o no.
`errorCode`	String	Expande el estado ERROR si es necesario desde los códigos de error predeterminados, que se asignarán a los errores que se presentan a los usuarios.
`debugString`	String	Es un error detallado a nivel del comando que nunca se presentará a los usuarios, pero que se puede registrar o usar durante el desarrollo.

Ejemplos

Respuesta del intent EXECUTE

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