Esquema do traço StartStop da casa inteligente

action.devices.traits.StartStop: essa característica pertence a dispositivos que oferecem suporte a operações de inicialização e interrupção.

Iniciar e interromper um dispositivo tem uma função semelhante a de ligar e desligar. Os dispositivos que herdam essa característica têm funções diferentes quando ligados e iniciados. Algumas máquinas de lavar, por exemplo, podem ser ligadas e ter as configurações modificadas antes de realmente iniciar a operação.

Ao contrário dos dispositivos que simplesmente têm um estado ligado e desligado, alguns dispositivos que podem iniciar e parar também podem ser pausados durante a execução de uma operação. Os dispositivos que podem pausar vão deixar de funcionar, mas, após a retomada, vão continuar no mesmo estado de quando estavam pausados. A retomada é diferente da inicialização/reinicialização, já que, independentemente do estado atual do dispositivo, a operação começará do início.

Alguns dispositivos são compatíveis com a execução em zonas específicas. Por exemplo, um sprinkler pode ter várias zonas de irrigação e suporta a capacidade de regar zonas específicas separadamente, enquanto um aspirador pode auxiliar a 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 o gerenciamento de intents SYNC, consulte 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 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 há suporte para o dispositivo inicial.

Exemplos

Dispositivo que pode ser pausado e compatível com a operação em várias zonas.

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

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
isRunning Booleano

Obrigatório.

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

isPaused Booleano

Indica se o dispositivo está explicitamente pausado. Se esse valor for verdadeiro, significa que isRunning é falso, mas pode ser retomado.

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á em execução?

{
  "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 o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.StartStop

Inicie ou pare o dispositivo.

Parâmetros

Parâmetros Tipo Descrição
start Booleano

Obrigatório.

Verdadeiro para iniciar a operação do dispositivo e falso para interromper.

zone String

Indica a zona em que começar a execução.

multipleZones Array

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

[item, ...] String

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

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 um estado 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

ERROS DO Dispositivo

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