Создайте автоматизацию по сценарию

1. Введение

Что вы узнаете

• Как спланировать и написать скрипт автоматизации.
• Как протестировать автоматизированную программу, созданную с помощью скрипта.

Что вам понадобится

• Телефон на базе Android или iOS с установленным приложением Google Home.
• Умный светильник или другое устройство, сертифицированное для работы с Google Home и позволяющее включать и выключать его.

2. Настройте ваше устройство.

Если ваше устройство еще не настроено, настройте его дома.

Убедитесь, что устройство отображается в приложении Google Home и что вы можете включать и выключать его с помощью приложения Home.

3. Спланируйте автоматизацию с помощью скриптов.

Начнём с того, что подумаем о том, что именно мы хотим, чтобы делала наша автоматизированная скриптовая программа. Это включает в себя такие аспекты, как:

• Какие устройства вы хотите автоматизировать?
• Какой инициатор (или событие) должен запустить выполнение скриптовой автоматизации?
• Какие дополнительные условия, если таковые имеются, определяют, будет ли выполняться скрипт автоматизации после его запуска?
• Какие действия необходимо выполнить?

В рамках этого практического занятия мы планируем, чтобы автоматизированная программа выполняла две задачи:

1. Включите свет (или другое умное устройство) в определенное время.
2. Выключайте устройство в определенное время.

Теперь, когда нам точно ясно, что именно мы хотим, чтобы делал наш скрипт автоматизации, мы откроем редактор скриптов и напишем скрипт автоматизации.

4. Напишите скрипт автоматизации.

Автоматизированные сценарии пишутся в декларативном стиле с использованием языка сериализации данных YAML .

Автоматизированный скрипт состоит из двух основных разделов:

1. Метаданные — название скрипта автоматизации и описание его функций.
2. Правила автоматизации — определяют логику запуска и поведение автоматизации.

Метаданные

Метаданные нашей автоматизации сообщают пользователю, как называется автоматизация и что она делает. Метаданные указываются в блоке metadata , который выглядит следующим образом:

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

Правила автоматизации

Правило автоматизации — это то, где происходит настоящая работа. Оно состоит из трех частей: инициализирующих условий, условий и действий , которые оцениваются в определенном порядке:

Блок automations нашего модуля автоматизации содержит два правила:

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. Существует два правила automations . Первое включает свет, а второе выключает.
2. Каждое правило выполняет только одно действие.
3. on: true означает включить свет . Аналогично, on: false означает выключить свет .
4. Каждое правило имеет один time.schedule starter, который указывает процессу автоматизации, в какое время его следует запустить.
5. В этой автоматизации нет никаких условий.

5. Полная автоматизация с помощью скриптов.

Собрав все эти элементы воедино, получаем вот как выглядит полная автоматизированная скриптовая система:

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. Скопируйте автоматизацию (выше).
2. Перейдите на главную страницу Google Home в веб-версии .
3. Выберите вкладку «Автоматизация», обозначенную значком с тремя звездочками:
   
4. Нажмите + Добавить новый .
5. В редакторе скриптов удалите шаблон автоматизации.
6. Вставьте вашу автоматизацию.
7. Замените Desk light - Office на название и местоположение вашего устройства.
8. Нажмите «Проверить» . Редактор скриптов подчеркнет разделы вашей автоматизации, содержащие ошибки. Устраните все возникшие ошибки и продолжайте проверку и исправление, пока ошибок не останется. Например, имя вашего устройства может отличаться. В этом случае вы можете использовать функцию автозаполнения, чтобы выбрать допустимое имя устройства.
9. Нажмите « Сохранить ».
10. Убедитесь, что переключатель «Активировать» , расположенный под текстом вашего скрипта, находится в положении «включено» :

6. Протестируйте автоматизацию.

1. Убедитесь, что ваше устройство подключено к сети и отображается в приложении Google Home.
2. Если устройство в данный момент включено, выключите его.
3. На странице «Автоматизация» в веб-версии Google Home нажмите кнопку «Запустить» рядом с вашей автоматизацией.
   
4. Устройство должно включиться.

Теперь давайте протестируем автоматизацию.

1. Выключите устройство.
2. Отредактируйте автоматизацию и измените время включения устройства в строке 7 на время на пять минут вперед.
3. Измените время выключения устройства в строке 14 на время, немного более позднее, чем время включения.
4. Нажмите «Проверить» . Устраните все возникшие ошибки.
5. Нажмите « Сохранить ».
6. Убедитесь, что переключатель «Активировать» находится в положении «включено» .
7. Дождитесь истечения двух заданных временных интервалов запуска. Устройство должно включиться и выключиться в указанное вами время.

7. Поздравляем!

Вы успешно создали скрипт автоматизации — отлично!

В этом практическом занятии вы научились:

• Как разработать и написать скрипт автоматизации.
• Как протестировать автоматизированную систему.

Следующие шаги

В этом практическом занятии мы создали очень простую автоматизацию. Автоматизация может делать гораздо больше, чем просто планировать переключение выключателя питания. Теперь, когда вы понимаете основы создания автоматизации, вы можете изучить различные типы запуска, условий и действий, доступных в экосистеме Google Home.

Попробуйте выполнить следующие упражнения:

• Добавьте в автоматизацию больше инициализирующих элементов time.schedule .
• Измените автоматизацию таким образом, чтобы другое устройство включалось и выключалось по тому же расписанию.
• Не удаляя параметры time.schedule , измените автоматизацию таким образом, чтобы устройства включались только тогда, когда включается другое устройство. Обратитесь к примерам скриптов , использующих condition .
• Измените настройки автоматизации таким образом, чтобы устройства включались только тогда, когда кто-то находится дома.

Дополнительная информация

Чтобы узнать больше об автоматизации Google Home, ознакомьтесь с документацией по автоматизации:

• Быстрый старт
• Поддерживаемые стартеры, условия и действия