Esquema de traço StartStop da casa inteligente

action.devices.traits.StartStop: esta característica pertence a dispositivos que permitem iniciar e interromper operações.

A inicialização e a interrupção de um dispositivo têm uma função semelhante à de ativá-lo e desativá-lo. 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 ativadas e ter as configurações modificadas antes do início da operação.

Ao contrário dos dispositivos que simplesmente têm um estado ativado e desativado, alguns dispositivos que podem iniciar e parar também podem pausar enquanto executam uma operação. Os dispositivos que podem pausar cessarão a operação, mas após a retomada, continuarão no mesmo estado em que estavam pausados. A retomada é diferente do início/reinicialização, independentemente do estado atual do dispositivo, e a operação será iniciada desde o início.

Alguns dispositivos podem ser compatíveis com a execução em determinadas zonas. Por exemplo, um sprinkler pode ter várias zonas de irrigação e dar suporte à capacidade de regar zonas específicas separadamente, enquanto um aspirador pode ajudar na limpeza de salas específicas.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de intent.

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. Esta lista não é exclusiva. Os usuários podem denunciar os nomes que desejarem.

[item, ...] String

Nome de uma zona compatível com o dispositivo inicial.

Exemplos

Dispositivo que possa ser pausado e que funcione em várias zonas.

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

STATES do dispositivo

As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte fulfillment de intent.

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á pausado explicitamente. Se o valor for verdadeiro, isso significa que isRunning é falso, mas pode ser retomado.

activeZones Array

Indica as zonas em que o dispositivo está em execução no momento, a partir da 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"
  ]
}

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.StartStop

Inicie ou interrompa o dispositivo.

Parâmetros

Parâmetros Tipo Descrição
start Booleano

Obrigatório.

Verdadeiro para iniciar a operação do dispositivo, falso para parar.

zone String

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

multipleZones Array

Indica duas ou mais zonas onde começar a executar. Será definido em vez de zone parameter.

[item, ...] String

Nome de uma zona na qual 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.

Verdadeiro para pausar, falso 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 algum estado em que não pode ser pausado.

Os valores suportados são:

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 gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Dispositivo ERRORS

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