Crear una automatización con secuencias de comandos

bookmark_border Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

1. Introducción

Qué aprenderás

• Cómo planificar y escribir una automatización de secuencias de comandos
• Cómo probar una automatización de secuencias de comandos

Requisitos

• Un teléfono Android o iOS con la app de Google Home instalada
• Una luz inteligente o cualquier otro dispositivo que esté certificado para Funciona con Google Home y que se pueda encender o apagar.

2. Configura el dispositivo

Si aún no lo hiciste, configúralo en tu casa.

Confirma que el dispositivo aparezca en la app de Google Home y que puedas encenderlo y apagarlo con la app de Home.

3. Planifica tu automatización de secuencias de comandos

Para comenzar, pensemos en lo que queremos que haga nuestra automatización de secuencias de comandos. Esto incluye consideraciones como las siguientes:

• Qué dispositivos quieres automatizar
• Qué activador (o evento) debe activar la ejecución de la automatización de secuencias de comandos.
• Qué condiciones adicionales, si las hay, controlan si la automatización de secuencias de comandos se ejecuta o no una vez que se activa.
• Qué acciones se deben realizar.

Para este codelab, nuestro plan es hacer que la automatización de secuencias de comandos haga dos cosas:

1. Enciende la luz (o cualquier otro dispositivo inteligente) a una hora específica.
2. Apaga el dispositivo a una hora específica.

Ahora que tenemos claro exactamente lo que queremos que haga nuestra automatización de secuencias de comandos, abriremos el editor de secuencias de comandos y la escribiremos.

4. Escribe la automatización de secuencias de comandos

Las automatizaciones de secuencias de comandos se escriben de forma declarativa con el lenguaje de serialización de datos YAML.

Una automatización de secuencias de comandos se compone de dos secciones principales:

1. Metadatos: Es el nombre de la automatización de secuencias de comandos y una descripción de lo que hace.
2. Reglas de automatización: Definen la lógica de inicio y el comportamiento de la automatización.

Metadatos

Los metadatos de nuestra automatización le indican al usuario cómo se llama y qué hace. Los metadatos se especifican en el bloque metadata, que se ve de la siguiente manera:

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times

Reglas de automatización

En una regla de automatización es donde se realiza el trabajo real. Consta de tres partes: activadores, condiciones y acciones, que se evalúan en orden:

El bloque automations de nuestra automatización contiene dos reglas:

automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

Ten en cuenta lo siguiente:

1. Hay dos reglas automations. El primero enciende la luz y el segundo la apaga.
2. Cada regla tiene una sola acción.
3. on: true significa enciende la luz. Del mismo modo, on: false significa apagar la luz.
4. Cada regla tiene un solo activador time.schedule que le indica a la automatización a qué hora iniciarla.
5. No hay condiciones en esta automatización.

5. La automatización completa de secuencias de comandos

Si juntamos todas estas partes, la automatización completa de secuencias de comandos se verá de la siguiente manera:

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times
automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

1. Copia la automatización (más arriba).
2. Ve a Google Home para la Web.
3. Selecciona la pestaña Automatizaciones, representada por un ícono con tres estrellas:
   
4. Haga clic en + Agregar nueva.
5. En el editor de secuencia de comandos, borra la plantilla de automatización.
6. Pega la automatización.
7. Reemplaza Desk light - Office por el nombre y la ubicación de tu dispositivo.
8. Haz clic en Validar. El editor de secuencias de comandos subraya las secciones de tu automatización de secuencias de comandos que contienen errores. Resuelve los errores que surjan y sigue validando y corrigiendo hasta que no haya más errores. Por ejemplo, el nombre de tu dispositivo puede ser diferente. Si ese es el caso, puedes usar la función de autocompletado para elegir un nombre de dispositivo válido.
9. Haz clic en Guardar.
10. Asegúrate de que el interruptor Activate, debajo del texto de la secuencia de comandos, esté en la posición on:

6. Prueba la automatización

1. Asegúrate de que el dispositivo esté conectado y sea visible en la app de Google Home.
2. Si el dispositivo está encendido, apágalo.
3. En la página Automatizaciones de Google Home para la Web, haz clic en el botón "Ejecutar" junto a tu automatización.
   
4. El dispositivo debería encenderse.

Ahora, probemos la automatización.

1. Apaga el dispositivo.
2. Edita la automatización y cambia la hora de "device on" en la línea 7 a una hora cinco minutos en el futuro.
3. Cambia la hora de "device off" en la línea 14 a una hora poco después de la "on time".
4. Haz clic en Validar. Resuelve cualquier error que pueda surgir.
5. Haz clic en Guardar.
6. Asegúrate de que el interruptor Activar esté en la posición activado.
7. Espera a que transcurran los dos tiempos de inicio. El dispositivo debería encenderse y apagarse en los horarios que especificaste.

7. ¡Felicitaciones!

¡Felicitaciones! Creaste correctamente una automatización de secuencias de comandos.

En este codelab aprendiste a hacer lo siguiente:

• Cómo diseñar y escribir una automatización
• Cómo probar una automatización

Próximos pasos

En este codelab, creamos una automatización muy simple. Las automatizaciones pueden hacer mucho más que programar el encendido y apagado de un interruptor de alimentación. Ahora que comprendes los conceptos básicos para crear una automatización, puedes explorar los diferentes tipos de activadores, condiciones y acciones que están disponibles en el ecosistema de Google Home.

Prueba los siguientes ejercicios:

• Agrega más activadores de time.schedule a la automatización.
• Modifica la automatización para encender y apagar otro dispositivo en el mismo horario.
• Sin quitar los activadores time.schedule, modifica la automatización para que solo encienda los dispositivos cuando otro dispositivo esté encendido. Consulta las secuencias de comandos de ejemplo que usan la cláusula condition.
• Modifica la automatización para que solo encienda los dispositivos cuando haya alguien en casa.

Lecturas adicionales

Para obtener más información sobre las automatizaciones de Google Home, explora la documentación de referencia de las automatizaciones:

• Inicio rápido
• Activadores, condiciones y acciones compatibles