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 OnOff de la casa inteligente

action.devices.traits.OnOff: La funcionalidad básica de activación y desactivación de cualquier dispositivo que tenga ejecutables de encendido y apagado, incluidos los enchufes, interruptores y muchos dispositivos futuros.

ATTRIBUTES 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 el manejo de intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
commandOnlyOnOff Booleano

(Predeterminado: false)

Indica si el dispositivo solo se puede controlar mediante comandos y no se puede consultar información de estado.

queryOnlyOnOff Booleano

(Predeterminado: false)

Indica si el dispositivo solo se puede consultar para obtener información de estado y no se puede controlar mediante comandos.

Ejemplos

Dispositivo que admite estados de comando y de activación y desactivación

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

Dispositivo que solo admite comandos de activación y desactivación.

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

Dispositivo (generalmente sensor) que solo admite la generación de informes sobre el estado de activado/desactivado.

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

Dispositivo STATEs

Los dispositivos con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
on Booleano

Si un dispositivo con un interruptor de encendido y apagado está activado o desactivado.

Ejemplos

¿El dispositivo está encendido?

{
  "on": true
}

¿El dispositivo está apagado?

{
  "on": false
}

Dispositivo COMMANDS

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 el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.OnOff

Enciende o apaga el dispositivo.

Parámetros

Parámetros Tipo Descripción
on Booleano

Obligatorio.

Encender o apagar el dispositivo

Ejemplos

Enciende el dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

Apaga el dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

Expresiones de muestra

de-DE

  • Bitte Licht aus
  • Bitte das Wohnzimmer einschalten
  • Bitte die Küche ausstellen
  • Lampen

en-US

  • apagar el AC
  • encender mis luces

es-ES

  • encender el robot de limpieza
  • enciéndeme el salón

fr-FR

  • Tu peux éteindre le sala ?
  • allume la chambre
  • allume les lumières
  • éteins les lumières

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.