Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esquema de características de StartStop de casa inteligente

action.devices.traits.StartStop: essa característica pertence a dispositivos que têm suporte para iniciar e interromper operações.

A inicialização e a interrupção de um dispositivo têm uma função semelhante à de ativação ou desativação. Os dispositivos que herdam essa característica funcionam de maneira diferente quando ligados e iniciados. Algumas máquinas, por exemplo, podem ser ativadas e ter as configurações modificadas antes de iniciar a operação.

Ao contrário dos dispositivos que simplesmente têm um estado ativado e desativado, alguns que podem iniciar e parar também podem pausar durante uma operação. Os dispositivos que podem ser pausados deixarão de funcionar, mas após a retomada continuarão no mesmo estado em que foram pausados. A retomada é diferente da inicialização/reinício porque, independentemente do estado atual do dispositivo, ela começará do início.

Alguns dispositivos podem ser compatíveis com a execução em determinadas zonas. Por exemplo, um aspersor pode ter várias zonas de irrigação e pode regar zonas específicas, enquanto o aspirador pode ajudar na limpeza de ambientes 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 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 com suporte. As strings precisam ser localizadas conforme definido pelo usuário. Essa lista não é exclusiva. Os usuários podem denunciar qualquer nome.

[item, ...] String

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

Exemplos

Dispositivo que pode ser pausado e oferece suporte para operação em várias zonas.

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

STATES do dispositivo

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

Estados Tipo Descrição
isRunning Booleano

Obrigatório.

Indica se o dispositivo está em operação.

isPaused Booleano

Indica se o dispositivo está pausado de forma explícita. Se esse 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 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 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 interromper.

zone String

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

multipleZones Array

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

[item, ...] String

Nome de uma zona em que o dispositivo será iniciado.

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

Ligar 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 um estado em que não é possível pausá-lo.

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.