Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de inicio StartStop de Smart Home

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

Iniciar y detener un dispositivo tiene una función similar a encenderlo y apagarlo. Los dispositivos que heredan esta función de característica de manera diferente cuando se encienden y se inician. Por ejemplo, algunas lavadoras pueden activarse y modificar su configuración antes de iniciar la 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 puedan pausar dejarán de funcionar, pero la reanudación continuará en el mismo estado que cuando se pausaron. La reanudación difiere del inicio o del reinicio, ya que independientemente del estado actual del dispositivo, esta acción comenzará a funcionar desde el principio.

Algunos dispositivos pueden admitir la ejecución en ciertas zonas. Por ejemplo, un aspersor puede tener varias zonas de riego y admite la capacidad de regar zonas particulares por separado, mientras que una aspiradora puede admitir la limpieza de habitaciones específicas.

ATRIBUTOS DEL Dispositivo

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 manejar 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 nombres de zonas compatibles. Las strings se deben localizar según lo establezca el usuario. Esta lista no es exclusiva; los usuarios pueden informar los nombres que quieran.

[item, ...] String

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

Ejemplos

Dispositivo que se puede pausar y 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 manejar 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 se pausó explícitamente. Si este valor es verdadero, implica que isRunning es falso, pero se puede reanudar.

activeZones Matriz

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

[item, ...] String

El nombre de la zona.

Ejemplos

¿El dispositivo está en pausa?

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

¿El dispositivo está en pausa?

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

¿Está funcionando el dispositivo?

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

Dispositivo COMMAND

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

Verdadero para iniciar el funcionamiento del dispositivo; falso para detener.

zone String

Indica la zona en la que se debe comenzar a ejecutar.

multipleZones Matriz

Indica dos o más zonas en las que debe comenzar a ejecutarse. Se establecerá en lugar de zone parameter..

[item, ...] String

Nombre de la zona en la que se va a 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 la operación del dispositivo.

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

Parámetros

Parámetros Tipo Descripción
pause Booleano

Obligatorio.

Verdadero para pausar; 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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.