Home Assistant: немного о шаблонах
Тема шаблонов (Templates) в HA всегда вызывает много вопросов, причем порой и у пользователей системы со стажем. Здесь я хочу собрать некоторое кол-во примеров с комментариями, которые помогут лучше понять принцип работы и синтаксис темплейтов.
Для погружения в тему, начать стоит как всегда с изучения официальной документации, а так же руководства на шаблонизатор Jinja2, именно его под капотом использует HA.
Шаблоны можно применять во множестве мест, начиная от объектов (например, создав собственный sensor или switch) и заканчивая скриптами, автоматизациями и интерфейсом lovelace. С их помощью можно получать необходимые данные из объектов (сущностей) — стейты и атрибуты, при необходимости модифицировать их, а так же реализовывать всевозможную логику (переменные, циклы, проверки и т.д.). Это по-настоящему мощный инструмент, открывающий массу возможностей.
Один из главных инструментов для работы с шаблонами находится в разделе «Панель разработчика» — «Шаблоны» (/developer-tools/template), здесь можно в он-лайн режиме проверить корректность составленного шаблона и оценить его результат. Не забывайте про него, это сохранит множество времени и нервов при отладке сложных конструкций, а так же поможет лучше понять как все это работает.
Коротко про синтаксис
Обратите внимание на оформление, в шаблонах могут использоваться строки с разным обрамлением:
- << >> — Expressions (выражения), эти конструкции после вычисления возвращают какой-то объект.
Пример: << as_timestamp(now()) | timestamp_custom ('%W') >> вернет номер текущей недели.
А << (state_attr('light.0x86bd7fffe616b72_light', 'brightness') >> — атрибут brightness (яркость) лампы. - <% %>— Statements (не знаю как правильно перевести), в этих конструкциях размещается все то, что содержит в себе какую-то «логику»: переменные, проверки if\else, циклы и т.д.
Пример: <% if is_state('group.family_persons', 'not_home') %>Никого нет <% endif %>вернет текст «Никого нет» если стейт у группы group.family_persons равен not_home.
По умолчанию, каждая строка шаблона на выходе будет оканчиваться символом новой строки «\n».
Причем даже те строки, которые ничего не выводят (например, объявление переменной — <% set a = 123 %>).
Об этом необходимо помнить и учитывать при составлении темплейта.
К примеру, если шаблон используется для вывода чего-либо на экран, можно потратить уйму времени в борьбе с лишними пустыми строками на выходе.
Для управления этим поведением в jinja2 существует специальный механизм:
- <<- >> или <%- %>знак минуса в левой части уберет символ новой строки до текущей.
- << ->> или <% -%>знак минуса в правой части уберет символ новой строки после текущей.
Помимо этого, стоит уделить время ресурсу yaml-multiline.info, на котором можно наглядно разобраться с вопросом форматирования и переноса строк в YAML’е (символы |, > и т.д.), это бывает полезно при форматировании многострочных шаблонов.
Отдельно стоит упомянуть о том, какие операторы можно использовать в шаблонах.
Полную информацию об этом стоит искать в документации на jinja, а вкратце это:
-
(сложение, вычитание, умножение и т.д.) (больше, меньше, равно и т.д.) (и, или, не)
Помимо этого, в выражениях можно использовать фильтры jinja и HA, передавая значения в них через символ «|».
Пример: ((states(‘sensor.0x158d0003230618_pressure’) | float) / 1.333) | round(2)
Важные моменты в документации, на которые стоит обратить особое внимание:
- 4 Важных правила написания шаблонов записи объектов, имена которых начинаются с чисел операторов в шаблонах
Примеры
Сенсоры и их атрибуты
С помощью шаблонов можно создавать как бинарные (on\off), так и обычные сенсоры:
В примерах выше используются простые выражения (Expressions) с использованием встроенных в HA функций is_state() и state_attr(). С полным перечнем функций и правилами их применения лучше всего ознакомится в документации.
Более интересный пример:
Здесь в качестве стейта (state) сенсора date_formatted будет выведен результат выражения
<< as_timestamp(states('sensor.date_time_iso')) | timestamp_custom('%d.%m.%Y') >> и дополнительно, в виде атрибута — день недели, получаемый с помощью ряда операций.
В качестве значения сенсора можно использовать произвольный текст, в этом примере в зависимости от состояния датчика двери (геркона) в стейт будет записан текст «Открыта» или «Закрыта» (речь про дверь):
Более комплексный пример:
Темплейты можно использовать практически во всех возможных местах, например в именах будущих сенсоров:
Или меняя иконку сенсора в зависимости от различных условий:
Switches
В выключателях так же есть возможность использовать шаблоны.
Например, можно создать выключатель телевизора с разными действиями на включение и выключение:
Скрипты и автоматизации
Самое широкое применение шаблоны встречают в скриптах и автоматизациях.
Скрипт для запуска уборки роботом-пылесосом конкретной комнаты (в интерфейсе input_select.room_to_vacuum это выпадающий список с комнатами):
Автоматизация, меняющая мощность работы робота-пылесоса:
Оповещение о произошедшей ошибке.
С помощью шаблона можно получить текст ошибки из атрибута error:
Автоматизация меняющая яркость лампы по двойному клику на кнопку (по кругу):
Плавное включение света в заданное в интерфейсе HA время (будильник):
Постепенное увеличение громкости:
Изменение громкости у выбранного из выпадающего списка источника:
Отправка оповещений о приходе или уходе из дома:
В примере выше сообщение будет выглядеть примерно так — «Александр скорее всего вне дома.»
Шаблон соберется в одну строку, т.к. перед ним указан символ «>», означающий замену символов новой строки на пробелы.
Еще одно оповещение, на этот раз о температуре в комнате (холодно или жарко):
Команда для телеграм-бота, возвращающая имена находящихся дома:
Здесь, в отличии от предыдущего примера, перед шаблоном указан символ «|», означающий сохранение всех переносов строк в шаблоне. Лишняя пустая строка из вывода убрана с помощью конструкции «<%-«.
Еще одна команда для бота, присылающая текущую погоду:
Здесь, в зависимости от стейта сенсора weather.gismeteo (sunny, rainy, snowy и т.д.) отправляется картинка соответствующая текущей погоде (картинки подготовлены заранее).
Я постарался собрать здесь как можно более разнообразные примеры использования шаблонов в HA, но т.к. эта тема невероятно обширная, получилось это у меня слабо… =)
В будущем я надеюсь дополнить заметку другими интересными (с разных точек зрения) примерами.
Wtr assistant что это
AH1 War Thunder вертолет камуфляж скачать бесплатно
Камуфляж в широком разрешении для Вертолета Ah-1 War Thunder
 Ис-7 в War Thunder: как получить танк [Просмотров: 5944] |
| Новости War Thunder: последние ответы разработчиков [Просмотров: 4192] |
| Т-55А War Thunder в обновлении 1.69 [Просмотров: 4336] |
| Sd.Kfz 234/2 «Пума» — немецкий бронеавтомобиль в War Thunder [Просмотров: 127205] |
| Пьяджо P.108B — итальянская авиация War Thunder 1.69 [Просмотров: 4031] |
War Thunder статистика игрока
Статистика Вар Тандер
War Thunder Assistant — это бесплатное мобильное приложение, которое позволяет вам следить за всеми событиями в игре прямо с вашего телефона!
Программа для анализа статистики и эффективности игрока для Ваших Android-устройств War Thunder Assistant — это официальное приложение от разработчиков War Thunder, которое позволяет анализировать свои успехи в игре. Вы не только сможете узнать сильные и слабые стороны своей игры, но и лучше изучить тактико-технические параметры всей техники в игре. Ведь помимо самой статистики, в приложении есть информация о самолетах и танках, а также новости и многое другое! Приложение War Thunder Assistant поможет вам узнать всю необходимую информацию о своей эффективности в игре. Вы узнаете не только свой рейтинг, но и боевую эффективность. Узнаете, на каких танках, какой нации и в каких режимах вы являетесь лучшим, сможете сравнить свои параметры со статистикой друзей и других игроков.
AppAssistant для Huawei: что это за приложение и нужно ли оно?
Huawei часто делают пустые заявления. Сначала они могут сказать одно, но через какое-то время передумать. В итоге разработка совершенно меняется или вовсе не выпускается. Может быть людей и вовсе хотят запутать, чтобы скрыть информацию о своей работе. Тем не менее, относительно последней их разработки в интернете появились актуальные новости.
Что собой представляет новая разработка?
Huawei выпустило новое приложение. Пока оно доступно только для Android. Всем пользователям Google Play придётся подождать. Его назвали Huawei Assistant. Очень сложно привести аналогию с другими похожими приложениями, ведь новинка по сути является объединением функций нескольких программ. По задумке, именно AppAssistent станет своеобразным помощником для пользователя и поможет ему использовать все функции своего смартфона. При этом пользователю не придётся переходить из одной программы в другую. Всё будет находиться в одном месте, что является невероятно удобным для всех.
AppAssistent нацелен стать универсальным приложением для контролирования телефона. Разработчики соединили функции нескольких программ, благодаря которым можно искать данные, файлы, все отправленные и приходящие сообщения, а также спокойно выходить в Интернет и просматривать новости.
Как скачать приложение?
Чтобы установить программу, нужно зайти в настройки и выбрать пункт безопасности и конфиденциальности. Там следует нажать на кнопку разрешения установки улит не из внутренних ресурсов. Далее по ссылке нужно скачать APK-файл на телефон. AppAssistent начнёт загрузку, после чего можно будет спокойно пользоваться новым приложением.
Конечно, только пользователь может решить, нужен ему AppAssistent или нет. Если требуется универсальное приложение, которое позволяет обеспечить быстрой доступ ко многим функциям, экономя при этом время, то AppAssistent — нужный выбор. Если нравится уже привычный распорядок вещей, и столько функций вовсе не требуется, то программу скачивать совсем не обязательно.