Esquema de atributos StartStop de Smart Home

action.devices.traits.StartStop: Este atributo pertenece a dispositivos que admiten operaciones de inicio y detención.

El inicio y la detención de un dispositivo tienen una función similar a la de encenderlo y apagarlo. Los dispositivos que heredan este atributo funcionan de manera diferente cuando se encienden y cuando se inician. Por ejemplo, algunas lavadoras se pueden encender y se puede modificar su configuración antes de iniciar la operación.

A diferencia de los dispositivos que solo tienen un estado de encendido y apagado, algunos dispositivos que pueden iniciarse y detenerse también pueden pausarse mientras se realiza una operación. Los dispositivos que pueden pausarse dejarán de funcionar, pero, cuando se reanuden, continuarán en el mismo estado que tenían cuando se pausaron. La reanudación difiere del inicio o reinicio, ya que, independientemente del estado actual del dispositivo, comenzará la operación desde el principio.

Es posible que algunos dispositivos admitan la ejecución en ciertas zonas. Por ejemplo, un sistema de riego puede tener varias zonas de riego y admitir la capacidad de regar zonas particulares por separado, mientras que una aspiradora puede admitir la limpieza de habitaciones específicas.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar intents.

Ejemplos

Dispositivo que se puede pausar y que admite el funcionamiento en varias zonas.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Ejemplos

¿El dispositivo está pausado?

{
  "isRunning": false,
  "isPaused": true
}

¿El dispositivo está pausado?

{
  "isRunning": true,
  "isPaused": false
}

¿El dispositivo está en ejecución?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.StartStop

Iniciar o detener el dispositivo

Parámetros

Ejemplos

Inicia el dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Detén el dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Inicia el dispositivo en la oficina.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Inicia el dispositivo en la cocina, el comedor y la sala de estar.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "Kitchen",
      "Dining room",
      "Living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Pausar o reanudar la operación del dispositivo

{
  "pausable": true
}

Parámetros

Ejemplos

Pausa el dispositivo.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Errores relacionados

El usuario intentó pausar un dispositivo, pero este se encuentra en un estado en el que no se puede pausar.

Valores admitidos:

unpausableState

Expresiones de muestra

ERRORES del dispositivo