Интеграция сторонних медиаплееров из HA в Алису как колонок

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

В этом руководстве мы разберем, как правильно переопределить свойства медиаплеера в системе HA с помощью интеграции yandex_smart_home (будь то официальный компонент или кастомный от dmitry-kazakov), чтобы Яндекс корректно обрабатывал все его возможности.

Подготовка оборудования и предварительные условия

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

1. Медиаплеер в HA: Это может быть ресивер Denon, Yamaha, интеграция Samsung TV, LG webOS, модуль Chromecast или кастомный плеер на базе ESPHome. Убедитесь, что сущность вида media_player.living_room_receiver имеет рабочие службы управления громкостью (media_player.volume_set, media_player.volume_up_down) и выбора источника (media_player.select_source).
2. Интеграция Yandex Smart Home: У вас должен быть настроен и связан аккаунт Яндекса с вашей установкой Home Assistant через облачное подключение или прямой доступ (Yandex Dialogs).
3. Стабильное сетевое соединение: Устройства должны находиться в одной локальной подсети с сервером Home Assistant.

Шаг 1. Переопределение типа устройства в configuration.yaml

Чтобы Яндекс понял, что перед ним не просто абстрактный медиаплеер, а конкретное устройство (например, ресивер или телевизор), его тип необходимо явно переопределить. Для этого используется секция entity_config в конфигурационном файле интеграции yandex_smart_home.

Откройте ваш файл configuration.yaml и найдите блок настройки интеграции. Добавьте конфигурацию для вашего медиаплеера:

yandex_smart_home:
  entity_config:
    media_player.living_room_receiver:
      name: "Ресивер в гостиной"
      room: "Гостиная"
      type: devices.types.media_device.receiver
      properties:
        - type: volume
          attribute: volume_level

Здесь мы принудительно задали тип devices.types.media_device.receiver. Также доступны следующие типы:

• devices.types.media_device.tv — для телевизоров.
• devices.types.media_device — для универсальных плееров.

Шаг 2. Конфигурация входов и режимов воспроизведения

Для переключения входов ресивера (HDMI 1, AUX, Bluetooth) Алисе требуется знать точный список доступных источников. В Home Assistant этот список хранится в атрибуте source_list. Интеграция умеет автоматически транслировать эти источники в Яндекс, но их имена часто бывают на английском языке, что затрудняет распознавание голосом.

Вы можете настроить маппинг источников прямо в конфигурации:

yandex_smart_home:
  entity_config:
    media_player.living_room_receiver:
      type: devices.types.media_device.receiver
      custom_modes:
        input_source:
          list:
            - business_name: "Игровая приставка"
              value: "HDMI1"
            - business_name: "Медиаплеер"
              value: "HDMI2"
            - business_name: "Телевизор"
              value: "TV"

Благодаря этому Алиса поймет команду: «Алиса, включи игровую приставку на ресивере» и отправит в Home Assistant команду выбора источника HDMI1.

Шаг 3. Синхронизация устройств и проверка

После внесения изменений в configuration.yaml выполните следующие шаги:

1. Перейдите в Панель управления Home Assistant ➡️ Настройки ➡️ Инструменты разработчика ➡️ вкладка YAML.
2. Выполните проверку конфигурации. Если ошибок нет, перезапустите интеграцию Yandex Smart Home (или полностью перезапустите сервер Home Assistant).
3. Откройте приложение «Дом с Алисой» на вашем смартфоне.
4. Перейдите в настройки, выберите пункт «Устройства» ➡️ «Интеграции» ➡️ выберите интеграцию Home Assistant и нажмите «Обновить список устройств».
5. Убедитесь, что ресивер появился в списке устройств с иконкой аудиосистемы, и назначьте его в нужную комнату.

Если вы также планируете связать управление телевизором с ресивером, ознакомьтесь с нашим подробным руководством по настройке управления телевизором через HDMI-CEC, что позволит включать и выключать всю мультимедиа-систему одной командой.

Шаг 4. Настройка сценариев совместной работы

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

Пример голосового сценария «Время кино»:

• ЕСЛИ: Произнесена фраза «Алиса, включи кино».
• ТОГДА:
  1. Выключить основной свет в гостиной.
  2. Включить светодиодную ленту за телевизором на 20% яркости.
  3. Включить телевизор и установить на ресивере вход HDMI2 (Медиаплеер).
  4. Задать громкость ресивера на уровень 30%.

Использование проброшенных медиаплееров делает управление домашним кинотеатром бесшовным и интуитивно понятным для всех членов семьи.