Esquema de atributo de início/parada da casa inteligente

action.devices.traits.StartStop: essa característica pertence a dispositivos com suporte a operações de início e interrupção.

A inicialização e a interrupção de um dispositivo têm uma função semelhante à ativação e desativação. Os dispositivos que herdam esse recurso funcionam de maneira diferente quando são ativados e iniciam. Algumas máquinas de lavar, por exemplo, podem ser ligadas e ter as configurações modificadas antes de iniciar a operação.

Ao contrário dos dispositivos que simplesmente têm um estado ligado e desligado, alguns dispositivos que podem ser iniciados e interrompidos também podem ser pausados durante uma operação. Os dispositivos que podem pausar vão interromper a operação, mas, ao retomar, vão continuar no mesmo estado em que foram pausados. A remoção da pausa é diferente de iniciar/reiniciar, porque, independente do estado atual do dispositivo, ela inicia a operação do início.

Alguns dispositivos podem ser executados em determinadas zonas. Por exemplo, um aspersor pode ter várias zonas de irrigação e oferecer suporte à irrigação de zonas específicas separadamente, enquanto um aspirador pode oferecer suporte à limpeza de cômodos específicos.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Exemplos

Dispositivo que pode ser pausado e oferece suporte a operações em várias zonas.

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

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Exemplos

O dispositivo está pausado?

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

O dispositivo está pausado?

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

O dispositivo está em execução?

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

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.StartStop

Iniciar ou parar o dispositivo.

Parâmetros

Exemplos

Iniciar o dispositivo.

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

Parar o dispositivo.

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

Iniciar o dispositivo no escritório.

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

Iniciar o dispositivo na cozinha, na sala de jantar e na sala de estar.

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

action.devices.commands.PauseUnpause

Pausar ou retomar a operação do dispositivo.

{
  "pausable": true
}

Parâmetros

Exemplos

Pausar o dispositivo.

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

Erros relacionados

O usuário tentou pausar um dispositivo, mas ele está em um estado em que não é possível fazer isso.

Valores aceitos:

unpausableState

Exemplos de declarações

ERROS do dispositivo