Создание виртуальных переключателей в Home Assistant для Алисы

Интеграция сервера Home Assistant с голосовым ассистентом Алиса от Яндекса открывает колоссальные возможности для гибкого управления компонентами современного умного дома. Однако многие начинающие энтузиасты часто сталкиваются с аппаратными и программными ограничениями, когда возникает необходимость запустить сложный многоуровневый скрипт, шаблонное действие или целую группу последовательных команд с помощью одной голосовой фразы. Напрямую транслировать сложные внутренние сценарии Home Assistant в экосистему Яндекса не всегда удобно, а в некоторых случаях технически невозможно из-за различий в архитектуре платформ.

Наиболее надежным, элегантным и отказоустойчивым решением данной проблемы является проектирование и внедрение виртуальных переключателей (так называемых template switches или input_boolean). Они выполняют роль своеобразного логического моста между облачной инфраструктурой Яндекса и вашей локальной операционной системой автоматизации.

Виртуальный переключатель отображается в штатном мобильном приложении «Дом с Алисой» как абсолютно стандартное реле или классический настенный выключатель. Когда вы произносите голосовую команду в сторону умной колонки Яндекс Станция, Алиса мгновенно обрабатывает запрос и переключает состояние этого виртуального тумблера. В этот же момент локальный сервер Home Assistant фиксирует изменение статуса сущности и незамедлительно запускает любые, даже самые тяжелые и разветвленные сценарии автоматизации.

Шаг 1. Создание базового логического помощника Input Boolean

На первом этапе нашей работы необходимо подготовить виртуальную переменную на сервере, которая будет физически хранить текущее состояние выключателя (включен или выключен). В терминологии Home Assistant подобные сущности называются вспомогательными элементами или просто помощниками.

Для быстрого создания такого помощника без редактирования конфигурационных файлов выполните следующие простые шаги:

1. Запустите веб-интерфейс вашего Home Assistant и перейдите в раздел Настройки.
2. В появившемся меню выберите пункт Устройства и службы, а затем откройте вкладку Вспомогательные элементы в верхней панели управления.
3. Нажмите кнопку Создать помощник в правом нижнем углу интерфейса.
4. Из предложенного списка типов выберите вариант Переключатель (в системе эта сущность регистрируется с префиксом input_boolean).
5. Укажите понятное русскоязычное имя, например, input_boolean.cinema_mode (в интерфейсе можно назвать «Режим Кино»), задайте желаемую иконку и подтвердите создание кнопкой Создать.

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

Шаг 2. Настройка Template Switch в конфигурационном файле YAML

Шаблонные переключатели (template switch) позволяют жестко связать изменение виртуального состояния с запуском любых системных служб, скриптов или физических реле. Это превращает обычную логическую переменную в гибкий управляющий инструмент.

Используя файловый менеджер или плагин Studio Code Server, откройте главный файл конфигурации configuration.yaml и внесите в него следующий блок кода:

switch:
  - platform: template
    switches:
      yandex_cinema_mode:
        friendly_name: "Режим Кино"
        value_template: "{{ is_state('input_boolean.cinema_mode', 'on') }}"
        turn_on:
          - service: input_boolean.turn_on
            target:
              entity_id: input_boolean.cinema_mode
          - service: script.turn_on
            target:
              entity_id: script.start_movie_setup
        turn_off:
          - service: input_boolean.turn_off
            target:
              entity_id: input_boolean.cinema_mode
          - service: script.turn_on
            target:
              entity_id: script.stop_movie_setup

Благодаря данной записи, как только Алиса пришлет сигнал на включение switch.yandex_cinema_mode, сервер переведет наш базовый помощник в статус on и параллельно вызовет выполнение локального сценария script.start_movie_setup. Этот скрипт может плавно гасить свет, опускать рулонные шторы на окнах и активировать питание мультимедийного проектора.

Шаг 3. Интеграция с Yandex Smart Home и синхронизация устройств

Созданный шаблонный переключатель необходимо передать в облако Яндекса для последующего управления. Процесс детальной первоначальной настройки облачного моста описан в нашей подробной инструкции по интеграции Home Assistant с Алисой через Yandex Dialogs.

Добавьте наш виртуальный переключатель в конфигурационный блок фильтрации интеграции:

yandex_smart_home:
  filter:
    include_entities:
      - switch.yandex_cinema_mode

После завершения редактирования сохраните изменения в файле. Перейдите в раздел Инструменты разработчика на панели Home Assistant, откройте вкладку YAML и обязательно выполните проверку конфигурации на отсутствие синтаксических ошибок. Если проверка прошла успешно, осуществите перезапуск сервера. Далее откройте приложение «Дом с Алисой» на мобильном телефоне, зайдите в настройки вашего приватного навыка и нажмите кнопку синхронизации устройств. Наш новый виртуальный переключатель успешно появится в назначенном помещении умного дома.

Шаг 4. Написание голосовых сценариев в приложении Яндекса

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

1. Запустите мобильное приложение «Дом с Алисой» на вашем смартфоне.
2. Перейдите во вкладку сценариев, нажмите кнопку + и выберите пункт Сценарий.
3. В поле условий «Если» выберите активацию по голосовой фразе и пропишите варианты: «Алиса, давай посмотрим кино» или «Алиса, активируй режим кинотеатра».
4. В поле действий «Тогда» найдите добавленный переключатель «Режим Кино» и укажите для него статус Включить.
5. Нажмите кнопку сохранения сценария.

Возможные проблемы и методы их оперативного устранения

В процессе эксплуатации вы можете столкнуться с тем, что виртуальное устройство перестает своевременно реагировать на голосовые триггеры. Прежде всего проверьте локальный статус сущности input_boolean.cinema_mode непосредственно через веб-панель управления Home Assistant. Если при ручном изменении состояния автоматизация запускается корректно, то неполадка локализована на стороне внешнего сетевого соединения или OAuth2-авторизации.

Также обратите внимание на правильность написания шаблона value_template. Незначительная синтаксическая ошибка или опечатка в названии отслеживаемого объекта сделает виртуальный выключатель недоступным (статус unavailable), из-за чего Алиса выдаст голосовую ошибку о недоступности прибора. Для глубокого тестирования выражений на языке Jinja2 всегда используйте встроенный интерактивный инструмент отладки на вкладке Шаблоны в инструментах разработчика Home Assistant.

Если вам нужно интегрировать старые приборы с инфракрасным портом, настройте проброс ИК-пультов от Broadlink из Home Assistant в Алису.