Внутри последовательности if действие переменных изменит только переменную people для этой последовательности.

 последовательность:
  # Установить для переменной people значение по умолчанию
  - переменные:
      человек: 0
  # Попробуйте увеличить людей, если Паулюс дома
  - если:
      - состояние: состояние
        entity_id: device_tracker.paulus
        состояние: "дом"
    затем:
      # В этой области и в этой точке последовательности люди == 0
      - переменные:
          люди: "{{ человек + 1 }}"
      # В этом масштабе людей теперь будет 1 . ..
      - сервис: уведомить.уведомить
        данные:
          message: "Дома {{ человек }} человек" # "Дома 1 человек"
  # ... но в этой области все равно будет 0
  - сервис: уведомить.уведомить
    данные:
      message: "Дома {{ человек }} человек" # "Дома 0 человек"
 

Проверка состояния

При выполнении скрипта вы можете добавить условие в основную последовательность, чтобы остановить дальнейшее выполнение. Когда условие не возвращает true , выполнение сценария прекращается. Существует множество различных условий, которые задокументированы на странице условий.

Действие условия только останавливает выполнение текущего блока последовательности. Когда он используется внутри действия повтора, остановится только текущая итерация цикла Repeat . Когда он используется внутри действия выбора, только действия внутри этого выберите остановится.

 # Если Паулюс дома, продолжайте выполнение скрипта ниже этих строк
- псевдоним: "Проверить, дома ли Паулюс"
  состояние: состояние
  entity_id: device_tracker.
  paulus
  состояние: "дом"
 

условие также может быть списком условий, и тогда выполнение продолжится, только если ВСЕ условия вернут true .

 - псевдоним: "Проверить, дома ли Паулюс И температура ниже 20"
  состояние:
    - состояние: состояние
      entity_id: "device_tracker.paulus"
      состояние: "дом"
    - условие: числовое_состояние
      entity_id: "датчик.температура"
      ниже: 20
 

Подождите, пока пройдет время (задержка)

Задержки полезны для временной приостановки вашего скрипта и запуска его позже. Мы поддерживаем различные синтаксисы для задержки, как показано ниже.

 # секунд
# Ожидание 5 секунд
- псевдоним: "Подожди 5 секунд"
  задержка: 5
 

 # ЧЧ:ММ
# Ожидание 1 час
- задержка: "01:00"
 

 
  # ЧЧ:ММ:СС
# Ожидание 1,5 минуты
- задержка: "00:01:30"
 

 # Поддерживает миллисекунды, секунды, минуты, часы, дни
# Можно использовать в комбинации, требуется хотя бы один
# Ждет 1 минуту
- задерживать:
    минут: 1
 

Все формы принимают шаблоны.

 # Ожидание, сколько минут input_number.minute_delay установлено в значение
- задержка: "{{состояния('input_number.minute_delay') | умножить (60) | int }}"
 

Подождите

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

Дождитесь шаблона

Это действие оценивает шаблон, и если оно истинно, сценарий будет продолжен. Если нет, то он будет ждать, пока это не станет правдой.

Шаблон переоценивается всякий раз, когда идентификатор объекта, на который он ссылается, изменяет состояние. Если вы используете недетерминированные функции, такие как

# Подождите, пока медиаплеер не остановится
- псевдоним: "Подождите, пока медиаплеер не остановится"
  wait_template: "{{ is_state('media_player.floor', 'stop') }}"
 

Дождитесь триггера

Это действие может использовать те же триггеры, которые доступны в разделе автоматизации триггер . См. Триггер автоматизации. Сценарий будет продолжаться всякий раз, когда срабатывает любой из триггеров. Все ранее определенные переменные триггера, переменные и переменные скрипта передаются триггеру.

 # Подождите, пока пользовательское событие или свет включится и останется включенным в течение 10 секунд.
- псевдоним: "Подождите MY_EVENT или включите свет"
  ожидание_для_триггера:
    - платформа: событие
      тип_события: MY_EVENT
    - платформа: государство
      entity_id: свет.СВЕТ
      к: "на"
      за: 10
 

Тайм-аут ожидания

Для обоих типов ожидания можно установить тайм-аут, по истечении которого скрипт продолжит выполнение, если условие/событие не выполняется. Тайм-аут имеет тот же синтаксис, что и delay , и, как и delay , также принимает шаблоны.

 # Подождите, пока датчик переключится на «включено» до 1 минуты, прежде чем продолжить выполнение.
- wait_template: "{{ is_state('binary_sensor.entrance', 'on') }}"
  время ожидания: "00:01:00"
 

Вы также можете прервать выполнение сценария по истечении тайм-аута, используя необязательное значение 9.0108 continue_on_timeout: ложь .

# Дождитесь события IFTTT или прервите работу после указанного тайм-аута.
- ожидание_для_триггера:
    - платформа: событие
      event_type: ifttt_webhook_received
      данные_события:
        действие:connected_to_network
  тайм-аут:
    минут: "{{ timeout_minutes }}"
  continue_on_timeout: ложь
 

Без continue_on_timeout: false сценарий будет продолжаться всегда, поскольку значение по умолчанию для continue_on_timeout равно true .

Переменная ожидания

После каждого завершения ожидания, либо из-за того, что условие было выполнено, либо произошло событие, либо истекло время ожидания, будет создана/обновлена ​​переменная

Это можно использовать для выполнения различных действий в зависимости от того, было ли выполнено условие, или для последовательного использования более одного ожидания при реализации одного тайм-аута в целом.

 # Выполнять различные действия в зависимости от того, было ли выполнено условие.
- wait_template: "{{ is_state('binary_sensor.door', 'on') }}"
  тайм-аут: 10
- если:
    - "{{ не ждать. завершено }}"
  затем:
    - сервис: script.door_did_not_open
  еще:
    - сервис: script.turn_on
      цель:
        идентификатор объекта:
          - script.door_did_open
          - script.play_фанфары
# Подождите всего 10 секунд.
- wait_template: "{{ is_state('binary_sensor.door_1', 'on') }}"
  тайм-аут: 10
  continue_on_timeout: ложь
- сервис: switch.turn_on
  цель:
    entity_id: switch.some_light
- ожидание_для_триггера:
    - платформа: государство
      entity_id: binary_sensor.door_2
      к: "на"
      за: 2
  тайм-аут: "{{ ожидания.осталось}}"
  continue_on_timeout: ложь
- сервис: switch.turn_off
  цель:
    entity_id: switch.some_light
 

Запустить событие

Это действие позволяет запустить событие. События можно использовать для многих вещей. Это может вызвать автоматизацию или указать другой интеграции, что что-то происходит. Например, в приведенном ниже примере он используется для создания записи в журнале регистрации.

 - псевдоним: "Событие Fire LOGBOOK_ENTRY"
  событие: LOGBOOK_ENTRY
  данные_события:
    Имя: Паулюс
    сообщение: просыпается
    entity_id: device_tracker.paulus
    домен: светлый
 

Вы также можете использовать event_data для запуска события с пользовательскими данными. Это можно использовать для передачи данных другому сценарию, ожидающему триггер события.

event_data принимает шаблоны.

 - событие: MY_EVENT
  данные_события:
    имя: мое событие
    customData: "{{ myCustomVariable }}"
 

Создание и использование пользовательских событий

В следующем примере автоматизации показано, как вызвать пользовательское событие с именем event_light_state_changed с entity_id в качестве данных события. Часть действия может быть внутри скрипта или автоматизации.

 - псевдоним: "Пожарное событие"
  курок:
    - платформа: государство
      entity_id: switch.kitchen
      к: "на"
  действие:
    - событие: event_light_state_changed
      данные_события:
        состояние: "включено"
 

В следующем примере автоматизации показано, как захватить пользовательское событие event_light_state_changed с помощью триггера автоматизации событий и получить соответствующий entity_id , который был передан в качестве данных триггера события. Дополнительные сведения см. в разделе Available-Trigger-Data.

 — псевдоним: «Захват события»
  курок:
    - платформа: событие
      event_type: event_light_state_changed
  действие:
    - сервис: уведомить.уведомить
      данные:
        сообщение: «кухонный свет включен {{ trigger.event.data.state }}»
 

Повторить группу действий

Это действие позволяет повторить последовательность других действий. Вложенность полностью поддерживается. Есть три способа контролировать, сколько раз будет запускаться последовательность.

Счетный повтор

Эта форма принимает значение счетчика. Значение может быть указано шаблоном, и в этом случае шаблон визуализируется при достижении шага повторения.

 скрипт:
  фонарик:
    режим: перезагрузка
    последовательность:
      - сервис: light.turn_on
        цель:
          entity_id: "свет.{{ свет }}"
      - псевдоним: "Включить свет "подсчет" раз"
        повторить:
          подсчет: "{{ подсчет|целое число * 2 - 1 }}"
          последовательность:
            - задержка: 2
            - сервис: light.toggle
              цель:
                entity_id: "свет.{{ свет }}"
  flash_hallway_light:
    последовательность:
      - псевдоним: "Вспышка света в коридоре 3 раза"
        служба: script.flash_light
        данные:
          свет: коридор
          количество: 3
 

За каждый

Эта повторяющаяся форма принимает список элементов для повторения. Список предметов может быть предварительно определенным списком или списком, созданным по шаблону.

Последовательность выполняется для каждого элемента в списке и текущего элемента в итерация доступна как repeat.item .

Следующий пример перевернет список источников света:

 повторить:
  для каждого:
    - "гостиная"
    - "кухня"
    - "офис"
  последовательность:
    - сервис: light.turn_off
      цель:
        entity_id: "свет.{{ Repeat.item }}"
 

Другие типы принимаются как элементы списка, например, каждый элемент может быть шаблон или даже сопоставление пар ключ/значение.

 повторить:
  для каждого:
    - английский язык
      сообщение: Привет мир
    - язык: голландский
      сообщение: Привет Wereld
  последовательность:
    - сервис: notify.phone
      данные:
        title: "Сообщение на {{ repeat.item.language }}"
        сообщение: "{{ Repeat.item.message }}!"
 

Пока цикл

Эта форма принимает список условий (доступные параметры см. на странице условий), которые оцениваются до каждый раз, когда последовательность работает. Последовательность будет выполняться 90 424 до тех пор, пока 90 425 условия не будут оценены как истинные.

 скрипт:
  сделай что-нибудь:
    последовательность:
      - сервис: script.get_ready_for_something
      - псевдоним: "Повторяйте последовательность до тех пор, пока выполняются условия"
        повторить:
          пока:
            - состояние: состояние
              entity_id: input_boolean.do_something
              состояние: "включено"
            # Не делайте этого слишком много раз
            - условие: шаблон
              value_template: "{{ repeat.index <= 20 }}"
          последовательность:
            - сервис: script.something
 

и также допускают сокращенное обозначение условия шаблона. Например:

 - повторить:
    в то время как: "{{ is_state('sensor.mode', 'Home') и repeat.index < 10 }}"
    последовательность:
    - . ..
 

Повторять до

Эта форма принимает список условий, которые оцениваются после каждый раз, когда последовательность работает. Поэтому последовательность всегда будет выполняться хотя бы один раз. Последовательность будет запущена до условия оцениваются как истинные.

 автоматика:
  - курок:
      - платформа: государство
        entity_id: двоичный_сенсор.xyz
        к: "на"
    состояние:
      - состояние: состояние
        entity_id: binary_sensor.something
        состояние: "выключено"
    режим: одиночный
    действие:
      - псевдоним: «Повторяйте последовательность, пока условия не будут выполнены»
        повторить:
          последовательность:
            # Выполнить команду, которая почему-то не всегда срабатывает
            - сервис: shell_command.turn_something_on
            # Дайте время для завершения
            - задерживать:
                миллисекунды: 200
          до:
            # Сработало?
            - состояние: состояние
              entity_id: binary_sensor. something
              состояние: "включено"
 

до также принимает сокращенное обозначение условия шаблона. Например:

 - повторить:
    до: "{{ is_state('device_tracker.iphone', 'home') }}"
    последовательность:
    - ...
 

Повторить переменную цикла

Переменная с именем Repeat определена в рамках действия Repeat (т. е. она доступна внутри последовательности , , а и до .) Он содержит следующие поля:

Если-то

Это действие позволяет условно ( если ) выполнить последовательность действий ( потом ) и опционально поддерживает запуск другой последовательности, когда условие не выполнялось. пройти ( иначе ).

 скрипт:
  - если:
      - псевдоним: "Если никого нет дома"
        состояние: состояние
        entity_id: zone.home
        состояние: 0
    затем:
      - псевдоним: "Тогда начинай уже чистить!"
        сервис: вакуум.старт
        цель:
          area_id: гостиная_комната
    # `else` не является обязательным и может быть опущен
    еще:
      - сервис: уведомить.уведомить
        данные:
          сообщение: "Уборка пропущена, кто-то дома!"
 

Это действие поддерживает вложенность, однако, если вы обнаружите, что используете вложенные if-then действия в части else , вы можете рассмотреть возможность использования вместо этого выберите.

Выберите группу действий

Это действие позволяет выбрать последовательность других действий из списка последовательностей. Вложенность полностью поддерживается.

Каждая последовательность сопровождается списком условий. (См. страницу условий, чтобы узнать о доступных параметрах и о том, как обрабатываются несколько условий. ) Будет запущена первая последовательность, все условия которой верны. необязательный по умолчанию может быть включена последовательность, которая будет выполняться только в том случае, если не выполняется ни одна из последовательностей из списка.

Необязательный Псевдоним может быть добавлен к каждой из последовательностей, за исключением последовательности по умолчанию .

Действие Choose можно использовать как оператор «if/then/elseif/then…/else». Первая пара условий / последовательность похожа на «если/то» и может использоваться сама по себе. Или можно добавить дополнительные пары, каждая из которых похожа на «элиф/то». И, наконец, 9Можно добавить 0108 по умолчанию , что похоже на «еще».

 # Пример с "if", "elif" и "else"
автоматизация:
  - курок:
      - платформа: государство
        entity_id: input_boolean.simulate
        к: "на"
    режим: перезагрузка
    действие:
      - выбирать:
          #ЕСЛИ утро
          - условия:
              - условие: шаблон
                value_template: "{{ now(). hour < 9 }}"
            последовательность:
              - сервис: script.sim_morning
          #ЭЛИФ день
          - условия:
              - условие: шаблон
                value_template: "{{ now().hour < 18 }}"
            последовательность:
              - сервис: light.turn_off
                цель:
                  entity_id: light.living_room
              - сервис: script.sim_day
        # ИНАЧЕ ночь
        по умолчанию:
          - сервис: light.turn_off
            цель:
              entity_id: светлая кухня
          - задерживать:
              минут: "{{диапазон(1, 11)|случайный}}"
          - сервис: light.turn_off
            цель:
              entity_id: все
 

условия также принимает сокращенное обозначение условия шаблона. Например:

 автоматика:
  - курок:
      - платформа: государство
        entity_id: input_select.home_mode
    действие:
      - выбирать:
          - условия: >
              {{ trigger.to_state. state == 'Дом' и
                 is_state('binary_sensor.all_clear', 'вкл') }}
            последовательность:
              - сервис: script.arrive_home
                данные:
                  хорошо: правда
          - условия: >
              {{ trigger.to_state.state == 'Дом' и
                 is_state('binary_sensor.all_clear', 'выкл') }}
            последовательность:
              - сервис: script.turn_on
                цель:
                  entity_id: script.flash_lights
              - сервис: script.arrive_home
                данные:
                  хорошо: ложь
          - условия: "{{ trigger.to_state.state == 'Нет на месте' }}"
            последовательность:
              - сервис: script.left_home
 

Подробнее выберите можно использовать вместе. Это случай IF-IF.

В следующем примере показано, как одна автоматизация может управлять объектами, которые не связаны друг с другом, но имеют один и тот же триггер.

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

 # Пример с "если" и "если"
автоматизация:
  - псевдоним: «Включать свет, когда солнце тускнеет и если какая-то комната занята»
      курок:
        - платформа: числовое_состояние
          entity_id: солнце.солнце
          атрибут: высота
          ниже: 4
      действие:
        # Это всегда должно применяться
        - сервис: light.turn_on
          данные:
            яркость: 255
            color_temp: 366
          цель:
            идентификатор объекта:
              - свет.крыльцо
              - свет.сад
        # ЕСЛИ сущность включена
        - выбирать:
            - условия:
                - состояние: состояние
                  entity_id: binary_sensor.livingroom_tv
                  состояние: "включено"
              последовательность:
                - сервис: light. turn_on
                  данные:
                    яркость: 255
                    color_temp: 366
                  цель:
                    entity_id: свет.гостиная
         # ЕСЛИ другая сущность, не связанная с предыдущей, включена
        - выбирать:
            - условия:
                - состояние: состояние
                  entity_id: binary_sensor.studio_pc
                  состояние: "включено"
              последовательность:
                - сервис: light.turn_on
                  данные:
                    яркость: 255
                    color_temp: 366
                  цель:
                    entity_id: light.studio
 

Распараллеливание действий

По умолчанию все последовательности действий в Home Assistant выполняются последовательно. Этот означает, что следующее действие начинается после завершения текущего действия.

Это нужно не всегда, например, если последовательность действий не зависит друг на друга и порядок не имеет значения. В этих случаях действие параллельно может использоваться для параллельного выполнения действий в последовательности, что означает, что все действия начинаются одновременно.

В следующем примере показана отправка сообщений одновременно (параллельно):

 автоматика:
  - курок:
      - платформа: государство
        entity_id: двоичный_сенсор.движение
        к: "на"
    действие:
      - параллельно:
          - сервис: уведомить.person1
            данные:
              message: "Эти сообщения отправляются одновременно!"
          - сервис: уведомить.person2
            данные:
              message: "Эти сообщения отправляются одновременно!"
 

Также возможен последовательный запуск группы действий внутри параллельного действия. Пример ниже демонстрирует, что:

 скрипт:
  пример_скрипт:
    последовательность:
      - параллельно:
          - последовательность:
              - ожидание_для_триггера:
                  - платформа: государство
                    entity_id: двоичный_сенсор. движение
                    к: "на"
              - сервис: уведомить.person1
                данные:
                  message: "Это сообщение ожидало триггера движения"
          - сервис: уведомить.person2
            данные:
              сообщение: "Мне отправлено немедленно и не ждите вышеуказанного действия!"
 

Параллельное выполнение действий может быть полезным во многих случаях, но используйте его с осторожность и только в случае необходимости.

Существуют некоторые предостережения (см. ниже) при использовании параллельных действий.

Хотя распараллеливание звучит заманчиво, в большинстве случаев это обычный последовательные действия будут работать нормально.

Некоторые предостережения относительно параллельного выполнения действий:

• Нет гарантии заказа. Действия будут запущены параллельно, но нет гарантии, что они будут выполнены в том же порядке.
• Если одно действие завершается ошибкой или ошибкой, другие действия будут выполняться до тех пор, пока они тоже закончили или ошиблись.
• Переменные, созданные/измененные в одном параллельном действии, недоступны в другом параллельном действии. Каждый шаг в распараллеливании имеет свою область видимости.

Остановка последовательности сценариев

Последовательность сценариев можно остановить в любой момент. С помощью действия остановить .

Действие стоп принимает в качестве входных данных текст, объясняющий причину остановки последовательность. Этот текст будет зарегистрирован и появится в автоматах и следы сценария.

stop может быть полезен для остановки сценария в середине последовательности, когда, например, условие не выполнено.

 - стоп: "Остановить оставшуюся часть последовательности"
 

Существует также опция error , указывающая, что мы останавливаемся из-за неожиданная ошибка. Он также останавливает последовательность, но отмечает автоматизацию или скрипт как не удалось запустить.

 - стоп: "Ну, это было неожиданно!"
  ошибка: правда
 

Продолжение ошибки

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

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

continue_on_error доступен для всех действий и установлен на ложь . Вы можете установить его на true , если хотите продолжить действие. последовательность, независимо от того, вызывает ли это действие ошибку.

В приведенном ниже примере показана установка continue_on_error для первого действия. Если возникает ошибка; это будет продолжаться до следующего действия.

 - псевдоним: "Если этот не сработает..."
  continue_on_error: правда
  сервис: notify.super_unreliable_service_provider
  данные:
    сообщение: "Я собираюсь ошибиться..."
- псевдоним: "Этот еще побежит!"
  служба: persistence_notification.create
  данные:
    заголовок: "Привет!"
    сообщение: "Я в порядке..."
 

Обратите внимание, что continue_on_error не подавляет/игнорирует неправильную конфигурацию или ошибки, которые Home Assistant не обрабатывает.

Отключение действия

Каждое отдельное действие в последовательности можно отключить, не удаляя его. Для этого добавьте к действию enabled: false . Например:

 # Пример скрипта с отключенным действием
сценарий:
 пример_скрипт:
 последовательность:
 # Это действие не будет выполняться, так как оно отключено.
 # Сообщение не будет отправлено.