Esquema de trait StartStop para casa inteligente

action.devices.traits.StartStop: Esta característica pertenece a dispositivos que admiten el inicio y la detención de operaciones.

Iniciar y detener un dispositivo tiene una función similar a encenderlo y apagarlo. Los dispositivos que heredan esta función de trait de manera diferente cuando se encienden y cuando se inician. Por ejemplo, algunas lavadoras pueden encenderse y modificar su configuración antes de iniciar su operación.

A diferencia de los dispositivos que simplemente tienen un estado de encendido y apagado, algunos dispositivos que pueden iniciarse y detenerse también pueden pausarse mientras realizan una operación. Los dispositivos que pueden pausarse cesarán su funcionamiento, pero al momento de reanudarlos seguirán en el mismo estado que cuando estaban en pausa. Reanudar no es lo mismo que iniciar o reiniciar, ya que independientemente del estado actual del dispositivo, esta acción comenzará a funcionar desde el principio.

Es posible que algunos dispositivos admitan el funcionamiento en ciertas zonas. Por ejemplo, un aspersor puede tener varias zonas de riego y admitir la capacidad de regar determinadas zonas por separado, mientras que una aspiradora puede admitir la limpieza de habitaciones específicas.

Dispositivo ATTRIBUTES

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
pausable Booleano

(Predeterminado: false)

Indica si el dispositivo se puede pausar durante el funcionamiento.

availableZones Matriz

Indica los nombres de zonas compatibles. Las strings deben localizarse según lo que establece el usuario. Esta lista no es exclusiva; los usuarios pueden informar el nombre que deseen.

[item, ...] String

Nombre de una zona en la que se admite el dispositivo de inicio.

Ejemplos

Dispositivo que se puede pausar y que admite el funcionamiento en varias zonas.

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

Dispositivo STATES

Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
isRunning Booleano

Obligatorio.

Indica si el dispositivo está actualmente en funcionamiento.

isPaused Booleano

Indica si el dispositivo está pausado explícitamente. Si este valor es verdadero, implica que isRunning es falso, pero se puede reanudar.

activeZones Matriz

Indica las zonas en las que se está ejecutando el dispositivo, de la lista de availableZones.

[item, ...] String

El nombre de la zona.

Ejemplos

¿El dispositivo está pausado?

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

¿El dispositivo está pausado?

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

¿El dispositivo se está ejecutando?

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

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.StartStop

Inicia o detén el dispositivo.

Parámetros

Parámetros Tipo Descripción
start Booleano

Obligatorio.

El valor es verdadero para iniciar la operación del dispositivo y falso para detenerlo.

zone String

Indica la zona en la que debe comenzar a ejecutarse.

multipleZones Matriz

Indica dos o más zonas en las que comenzar la ejecución. Se establecerá en lugar de zone parameter..

[item, ...] String

Nombre de la zona en la que se iniciará el dispositivo.

Ejemplos

Enciende el dispositivo.

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

Detén el dispositivo.

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

Enciende el dispositivo en la oficina.

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

Enciende el dispositivo en la cocina, el comedor y la sala de estar.

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

action.devices.commands.PauseUnpause

Pausa o reanuda el funcionamiento del dispositivo.

Este comando requiere los siguientes atributos:
{
  "pausable": true
}

Parámetros

Parámetros Tipo Descripción
pause Booleano

Obligatorio.

Verdadero para pausar y Falso para reanudar.

Ejemplos

Pausa el dispositivo.

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

El usuario intentó pausar un dispositivo, pero este se encuentra en un estado en el que no se puede pausar.

Valores admitidos:

unpausableState

Expresiones de muestra

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

ERRORS de dispositivos

Consulta la lista completa de errores y excepciones.