Crear una automatización con secuencias de comandos

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

Qué necesitarás

• Un teléfono Android o iOS con la app de Google Home
• Una lámpara inteligente o algún otro dispositivo certificado para Funciona con Google Home y que se pueda encender o apagar

2. Configura el dispositivo

Si aún no se configuró el dispositivo, configúralo en tu casa.

Confirma que el dispositivo aparece en la app de Google Home y que puedes encenderlo y apagarlo con esa app.

3. Planifica la automatización de secuencias de comandos

Comencemos por pensar 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 los fines de este codelab, nuestro plan es que la automatización de secuencias de comandos haga dos cosas:

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

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

4. Escribe la automatización de secuencias de comandos

Las automatizaciones con 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: Define la lógica de iniciación y el comportamiento de la automatización.

Metadatos

Los metadatos de nuestra automatización le indican al usuario cómo se llama la automatización 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

Una regla de automatización es el lugar 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. La primera enciende la luz y la segunda la apaga.
2. Cada regla tiene una sola acción.
3. on: true significa activar la luz. Del mismo modo, on: false significa desactivar 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 las secuencias de comandos

Uniendo todos estos elementos, así se ve la automatización completa de las secuencias de comandos:

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. Copie la automatización (arriba).
2. Ve a Google Home para la Web.
3. Selecciona la pestaña de automatizaciones, representada por un ícono con tres estrellas:
   
4. Haga clic en + Agregar nueva.
5. En el editor de secuencias 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 continúa con la validación y la corrección hasta que no haya más errores. Por ejemplo, el nombre de tu dispositivo puede ser diferente. En ese caso, puedes usar la función de autocompletar para elegir un nombre de dispositivo válido.
9. Haz clic en Guardar.
10. Asegúrate de que el interruptor Activar, debajo del texto de la secuencia de comandos, esté en la posición de activado:

6. Prueba la automatización

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

Ahora, probemos la automatización.

1. Apaga el dispositivo.
2. Edita la automatización y cambia la hora de "dispositivo encendido" en la línea 7 a una hora de cinco minutos en el futuro.
3. En la línea 14, cambia la hora en que el dispositivo está apagado por un horario poco después de la hora en "En horario".
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 de activado.
7. Espera a que transcurran los dos horarios de inicio. El dispositivo debe encenderse y apagarse en los horarios que especificaste.

7. Felicitaciones.

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

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 la activación de un interruptor de encendido. Ahora que comprendes los conceptos básicos de la creación de una automatización, puedes explorar los diversos tipos de activadores, condiciones y acciones disponibles en el ecosistema de Google Home.

Prueba los siguientes ejercicios:

• Agrega más activadores time.schedule a la automatización.
• Modifica la automatización para encender y apagar otros dispositivos con el mismo programa.
• Sin quitar los activadores time.schedule, modifica la automatización para encender los dispositivos solo cuando esté encendido otro dispositivo. Consulta las secuencias de comandos de ejemplo que usan la cláusula condition.
• Modifica la automatización para encender los dispositivos solo 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 sobre las automatizaciones:

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