Esquema de traço Smart Home StartStop

action.devices.traits.StartStop: esse trait pertence a dispositivos que oferecem suporte a operações de início e interrupção.

Iniciar e parar um dispositivo tem uma função semelhante a ligar e desligar. Os dispositivos que herdam essa característica funcionam de maneira diferente quando são ligados e iniciados. 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 têm apenas um estado ligado e desligado, alguns dispositivos que podem iniciar e parar também podem pausar durante a execução de uma operação. Os dispositivos que podem pausar vão interromper a operação, mas, ao serem retomados, vão continuar no mesmo estado em que estavam quando foram pausados. Retomar é diferente de iniciar/reiniciar porque, independente do estado atual do dispositivo, a operação vai começar do início.

Alguns dispositivos podem ser executados em determinadas zonas. Por exemplo, um aspersor pode ter várias zonas de irrigação e permitir regar zonas específicas separadamente, enquanto um aspirador de pó pode limpar 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 como processar intents SYNC, consulte Lógica de fulfillment de intents.

Atributos Tipo Descrição
pausable Booleano

Padrão: false.

Indica se o dispositivo pode ser pausado durante a operação.
availableZones Array

Indica os nomes de zonas compatíveis. As strings precisam ser localizadas conforme definido pelo usuário. Essa lista não é exclusiva. Os usuários podem denunciar qualquer nome que quiserem.
[item, ...] String

Nome de uma zona em que o dispositivo inicial é compatível.

Exemplos

Dispositivo que pode ser pausado e funciona 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 como processar intents QUERY, consulte Lógica de fulfillment de intents.

Estados Tipo Descrição
isRunning Booleano

Obrigatório.

Indica se o dispositivo está em operação no momento.
isPaused Booleano

Indica se o dispositivo está explicitamente pausado. Se esse valor for verdadeiro, isso implica que isRunning é falso, mas pode ser retomado. Quando isPaused é falso, o campo só pode ser retornado de QUERY ou do estado do relatório, mas não de ambos. Retornar is_paused em ambos PODE causar erros de imprecisão no estado do relatório devido a diferenças de estado.
activeZones Array

Indica as zonas em que o dispositivo está sendo executado no momento, na lista de availableZones.
[item, ...] String

O nome da zona.

Exemplos

O dispositivo está pausado?

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

O dispositivo está pausado?

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

O dispositivo está funcionando?

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

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar intents EXECUTE, consulte Lógica de fulfillment de intents.

action.devices.commands.StartStop

Ligue ou desligue o dispositivo.

Parâmetros

Parâmetros Tipo Descrição
start Booleano

Obrigatório.

True para iniciar a operação do dispositivo, false para interromper.
zone String

Indica a zona em que a execução será iniciada.
multipleZones Array

Indica duas ou mais zonas em que a execução será iniciada. Será definido em vez de zone parameter.
[item, ...] String

Nome de uma zona para iniciar o dispositivo.

Exemplos

Inicie o dispositivo.

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

Pare o dispositivo.

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

Inicie o dispositivo no escritório.

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

Inicie 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.

Esse comando requer os seguintes atributos: 
{
  "pausable": true
}

Parâmetros

Parâmetros Tipo Descrição
pause Booleano

Obrigatório.

"True" para pausar, "false" para retomar.

Exemplos

Pause o dispositivo.

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

O usuário tentou pausar um dispositivo, mas ele está em um estado em que não pode ser pausado.

Valores compatíveis:

unpausableState

Exemplos de declarações

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット を リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

ERROS do dispositivo

Confira a lista completa de erros e exceções.