AlexxIT/YandexStation

Яндекс.Станция для Home Assistant

Компонент для управления Яндекс.Станцией и другими устройствами Умного дома с Алисой из Home Assistant.

• Колонки бренда Яндекс поддерживают локальное и облачное управление одновременно
• Колонки других брендов поддерживают только облачное управление
• Яндекс Модули поддерживают только локальное управление
• Устройства из умного дома с Алисой поддерживают только облачное управление

В тексте часто используются термины локальная колонка, локальный режим и локальное управление (они несут одинаковый смысл). Внимательно изучите, какие колонки его поддерживают. Функции и возможности локального управления сильно превосходят облачное управление. Облачное управление поддерживается на всех колонках, но не поддерживается на модулях. Локальный режим включается автоматически на поддерживаемых колонках.

У облачного управления нет обратной связи от колонки. Неизвестно, играет ли колонка что-то или стоит на паузе, и какая у неё актуальная громкость. Так что состояние колонки в Home Assistant может отличаться от актуального состояния колонки, если вы давали ей команды не из компонента.

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

• управление воспроизведением и громкостью станции
• отправка TTS на станцию из окна медиаплеера и через сервисы (голосом Алисы!)
• отправка любых текстовых команд на станцию из окна медиаплеера и через сервисы (например, включи мою музыку)
• спецэффекты в TTS (библиотека звуков и наложение эффектов на голос Алисы)

Дополнительные возможности локального управления:

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

Оглавление

• Полезные компоненты
• Установка
• Настройка

Возможности всех колонок

• Первый способ вызвать TTS
• Спецэффекты в TTS
• Медиа браузер
• Внешний вид
• Выполнение команд станцией
• Примеры управления станцией
• Получение команд от станции
• Интеграция с Яндекс.Диалогами
  • Второй способ вызвать TTS
  • Диалог с колонкой
• Уведомления и предупреждения
• Будильники

Возможности локальных колонок

• Третий способ вызвать TTS
• Громкость TTS
• Стриминг музыки
• Караоке
• Проигрывание медиа по ссылкам
• Проигрывание локальной музыки
• Анимация на экране колонки
• Получение ответов от колонки
• Яндекс Алиса в Telegram
• Список покупок
• Статический IP для колонки

Прочие функции

• Управление умным домом Яндекса
• Изменение настроек Алисы
• Изменение языка Алисы
• Несколько TTS в конфиге
• Звук Яндекс.Станции по HDMI
• Управление яркостью экрана станции Макс
• Поиск и устранение проблем
• Полезные автоматизации
• Полезные ссылки

Полезные компоненты

Не все из этих компонентов за моим авторством!

• Yandex.Station - позволяет управлять вашими колонками с Алисой из Home Assistant, отправлять на них голосовые уведомления и много чего ещё
• Yandex Smart Home - позволяет добавить ваши умные устройства из Home Assistant в умный дом Яндекса и управлять ими с любого устройства с Алисой, в том числе с колонок
• Браузер Яндекс.Музыки - позволяет выбирать и включать треки Яндекс.Музыки из Home Assistant
• YandexDialogs - позволяет получать команды от устройств с Алисой в Home Assistant через платформу Яндекс.Диалоги
• Yandex.Station Intents - позволяет получать команды от устройств с Алисой в Home Assistant через сценарии Яндекса
• HassWP - позволяет быстро и легко "попробовать" Home Assistant на компьютере Windows
• Dataplicity - позволяет легко огранизовать публичный HTTPS-доступ к вашему серверу Home Assistant
• Morph Numbers - позволяет правильно склонять числительные для отправки в TTS или Telegram
• VacuumZones - позволяет легко управлять зональной уборкой на пылесосах Xiaomi с помощью голосовых команд

Установка

Способ 1. HACS > Интеграции > Добавить > Yandex.Station > Установить

Способ 2. Вручную скопируйте папку yandex_station из latest release в директорию /config/custom_components.

Настройка

Внимание: Для каждой вашей колонки в мобильном приложении Яндекса будет создан служебный сценарий с именем ХА UUID. Не трогайте его. Если случайно удалили - перезапустите Home Assistant.

Настройки > Интеграции > Добавить интеграцию > Yandex Station

Если интеграции нет в списке - очистите кэш браузера.

Стабильные способы авторизации:

• QR-код - рекомендуется, самый удобный способ
• Cookies - компонент подскажет, что нужно сделать
• Токен - можно скопировать ТОЛЬКО из другого сервера Home Assistant, где уже была пройдена авторизация

Нестабильные способы авторизации (могут не работать):

• Пароль - при обычной авторизации
• Одноразовый пароль - из приложения Яндекс.Ключ, при включенной двухфакторной авторизации
• Ссылка на E-mail - поддерживается не на всех аккаунтах

В итоге компонент получит токен Яндекса и сохранит именно его, ваш пароль нигде не сохраняется.

Возможности всех колонок

В тексте часто приводятся разные примеры скриптов и автоматизаций. Их можно использовать:

• вручную вызывая сервисы из интерфейса
• создавая скрипты и автоматизации в интерфейсе
• добавляя примеры в configuration.yaml

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

В некоторых примерах используются события (event_type). За их срабатыванием можно следить тут.

В случае возникновения ошибок, их список и описание можно посмотреть тут.

Данная документация не призвана научить вас основам работы с Home Assistant.

Первый способ вызвать TTS

Работает на всех колонках

Начиная с версии интеграции v3.19.0, команда будет отправлена в локальном режиме, если колонка его поддерживает, и в облачном режиме, если колонка его не поддерживает.

В облачном режиме есть ограничение на 100 символов в тексте. Компонент автоматически ограничит длину текста до допустимой.

script:
  yandex_tts1:
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: 'Температура в комнате {{ states("sensor.temperature_hall")|round }} градуса'
        media_content_type: text

Спецэффекты в TTS

Поддерживается:

• только в локальном режиме (в режимах text и dialog)
• в облачном режиме, используя интеграцию с Яндекс.Диалогами

Доступны следующие эффекты, библиотека звуков, настройка речи и голоса:

• Настройка генерацию речи

  media_content_id: смелость sil <[500]> город+а берёт
  

• Наложение эффектов на голос

  media_content_id: <speaker effect="megaphone">Ехал Грека через реку <speaker effect="-">видит Грека в реке рак
  

• Шёпот

  media_content_id: <speaker is_whisper="true">Хозяин, уже утро, пора вставать!
  

• Библиотека звуков

  media_content_id: <speaker audio="alice-sounds-game-win-1.opus"> У вас получилось!
  

• Собственное аудио Можно загрузить свои аудио файлы до 120 секунд. Для воспроизведение загруженного аудиофайла нет необходимости использовать Яндекс.Диалог, в контекст которого загружен файл.

  media_content_id: <speaker audio="dialogs-upload/5d77ecc4-b781-4baa-abdd-bd0127553b97/081b7f9e-e708-499c-a907-264e33f28ecd.opus">
  

• Разные голоса можно посмотреть тут. Работают не все голоса. Если указать неправильный голос - колонка заглючит. Тогда на неё нужно отправить команду стоп или перезагрузить.

  media_content_id: <speaker voice="zahar">Всем привет. Меня зовут Захар...
  

script:
  yandex_tts:
    alias: TTS c эффектами
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: <speaker audio="alice-sounds-game-win-1.opus"> sil <[500]> Объявление погоды на сегодня...
        media_content_type: dialog  # работает только на локальной колонке

Медиа браузер

Фразы на колоки с Алисой можно отправлять, как из автоматизации, так и из интерфеса Home Assistant. Начиная с версии v2022.3 меню TTS перенесено в раздел Медиа, до этого оно находилось в окне Медиа плеера.

При желании вы можете настроить этот раздел через YAML:

• произносить фразы в разных режимах
• использовать спецэффекты и шаблоны
• отправлять команды на колоку
• задать перечень "быстрых команд"

Если в команде присутствует media_content_id или в template нет слова message - окно ввода сообщения будет пропущено.

Вот несколько примеров:

yandex_station:
  media_source:
    - title: Произнеси текст  # обязательное поле
      media_content_type: text  # обязательное поле
      thumbnail: https://brands.home-assistant.io/_/tts/icon.png
    - title: Выполни команду
      media_content_type: command
      thumbnail: https://brands.home-assistant.io/_/automation/icon.png
    - title: Включи любимое
      media_content_id: Включи моё любимое вперемешку
      media_content_type: command
    - title: Произнеси шепотом 
      template: '<speaker is_whisper="true">{{ message }}'
      media_content_type: dialog
      extra:
        volume_level: 0.2
    - title: Статус эквалайзера
      template: 'Эквалайзер установлен на {{ states("select.yandex_station_equalizer") }}'
      media_content_type: text

Внешний вид

Пример карточки плеера. Внимание: Этой карточки нет в Home Assistant по умолчанию. Она легко ставится через HACS. Если у вас сложности с установкой - просто используйте стандартную карточку. Она тоже работает.

Красивые иконки Яндекс устройств так же можно установить через HACS.

Выполнение команд станцией

Работает на всех колонках

script:
  yandex_command:  # работает и в локальном и в облачном режиме
    alias: Выполнить команду
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: Включи мою любимую музыку вперемешку
        media_content_type: command

Примеры управления станцией

Поддерживаются команды на несколько станций одновременно (как TTS, так и media_player).

Работает на всех колонках

script:
  yandex_volume_set:  # в локальном или облачном режиме
    alias: Меняем громкость нескольких станций
    sequence:
    - service: media_player.volume_set
      data:
        entity_id:
        - media_player.yandex_station_12345678901234567890
        - media_player.yandex_station_98765432109876543210
        volume_level: 0.5

Только для локального режима!

script:
  yandex_play_album:  # только в локальном режиме!!!
    alias: Включить Би-2 на Станции
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: 60062    # ID альбома в Яндекс.Музыка
        media_content_type: album  # album, track or playlist

Получение команд от станции

Работает на всех колонках

1. Создайте новый Сценарий в интерфейсе Яндекса.
2. Выберите "Фраза" в разделе Если
3. Выберите "Любое умное устройство" в разделе Тогда

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

Если хотите, чтоб команда бесшумно ушла в ХА - укажите выполнить команду ничего не делай.

Когда колонка выполнит такой сценарий, в ХА появятся два события с дополнительными параметрами:

• yandex_speaker - срабатывает ТОЛЬКО на "Выполнить команду" и может не срабатывать, если включена бета YandexGPT 2

  instance: text_action
  value: ничего не делай                # фраза колонке из раздела То
  entity_id: media_player.station_mini  # ID колонки в ХА
  name: Яндекс Мини                     # имя колонки в ХА
  

• yandex_scenario - срабатывает почти на любые действия в "Тогда"

  instance: sound_play
  value:
    sound: boot-1
    sound_name: Загрузка (8 бит)
  entity_id: media_player.station_mini  # ID колонки в ХА
  name: Яндекс Мини                     # имя колонки в ХА
  scenario_name: Тест                   # имя сценария в Яндексе
  

По любому из событий вы можете создавать автоматизации:

automation:
- alias: Расскажи шутку
  trigger:
  - platform: event
    event_type: yandex_speaker
    event_data:
      value: ничего не делай  # фраза из Сценария Яндекса (раздел То) 
  action:
  - service: media_player.play_media
    target:
      entity_id: '{{ trigger.event.data.entity_id }}'  # ответить той же колонкой
    data:
      media_content_type: text
      media_content_id: '{{ ["На связи", "Смольный слушает", "Тут я"]|random }}'
  mode: single

К сожалению, нельзя узнать фразу, которую сказали колонке. Можно узнать только фразу, которую колонка выполнила.

Для создания нескольких сценариев с "бешумным выполнением", используйте знаки пунктуации -,!.:=? и их комбинации ничего не делай???!!!. Эффект не изменится, а в ХА вы сможете различать, на какую фразу произошла реакция.

В разделе trigger: > event_data: вы можете фильтровать колонки, чтоб выполнять разные автоматизации для разных комнат на одну и ту же фразу.

Внимание! Вызов TTS из ХА так же активирует эти события.

Для отладки событий перейдите в панель разработчика вашего ХА по адресу http://192.168.1.123:8123/developer-tools/event, в разделе "подписаться на событие" укажите yandex_speaker и нажмите "подписаться".

Интеграция с Яндекс.Диалогами

Компонент поддерживает интеграцию с другим моим компонентом - YandexDialogs. При его наличии вам доступны функции:

Второй способ вызвать TTS

Работает на всех колонках

Поддерживает спецэффекты TTS. Нет ограничения на 100 символов. Послее TTS колонка НЕ слушает пользователя.

В media_content_type вы должны указать имя своего Яндекс.Диалога через двоеточие без пробелов. Регистр неважен.

script:
  yandex_tts3:
    sequence:
      - service: media_player.play_media
        entity_id: media_player.yandex_station_irbis
        data:
          media_content_id: <speaker is_whisper="true">Хозяин, пора бы спать
          media_content_type: text:умный дом

Диалог с колонкой

Работает на всех колонках

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

В media_content_type вы должны указать имя своего Яндекс.Диалога через двоеточие без пробелов. Регистр неважен. И через второе двоеточие некий "тег" диалога, чтоб потом в автоматизации понять, на какой вопрос вам пришёл ответ.

script:
  yandex_dialog:
    sequence:
      - service: media_player.play_media
        entity_id: media_player.yandex_station_mini
        data:
          media_content_id: <speaker is_whisper="true">Хозяин, уже утро, пора вставать!
          media_content_type: dialog:умный дом:утро

Пример реакции на ответ пользователя можно посмотреть тут. Этим подходом легко пользоваться как в автоматизациях Home Assistant, так и в Node-RED.

Уведомления и предупреждения

Компонент поддерживает уведомления и предупреждения.

Уведомления это альтернативный способ вызвать TTS. Уведомления настраиваются в configuration.yaml. Минимально, вы должны указать имя нового уведомления и перечень колонок, где оно должно звучать. Для каждого уведомления будет создан отдельный сервис. Далее необходимо вызывать этот сервис с параметром message.

Опционально уведомления поддерживают параметр title. Для его поддержки вы можете использовать шаблон из примера ниже.

При настройке уведомлений параметры media_content_id и media_content_type необязательные.

Уведомления можно использовать в предупреждениях. Например, если вы забыли закрыть выходную дверь - предупреждение будет отправлять вам уведомление с заданным интервалом, до тех пор, пока проблема не будет решена.

notify:
  - name: alice_alert  # любое название
    platform: yandex_station
    data:
      entity_id: media_player.yandex_station_mini  # замените на вашу колонку
      media_content_id: >-
        {% if title is defined %}<speaker effect="megaphone">{{ title }}<speaker effect="-"> sil <[200]>{% endif %}{{ message }}
      media_content_type: dialog

input_boolean: # просто для примера
  garage_door:
    name: Дверь гаража

alert:
  garage_door:
    name: Гараж открыт
    done_message: Гараж закрыт
    entity_id: input_boolean.garage_door
    state: "on"  # опционально, потому что "on" это значение по умолчанию
    repeat: 5  # как часто повторять, в минутах
    can_acknowledge: true  # разрешить выключить уведомления вручную
    skip_first: true  # пропустить первое (мгновенное) уведомление
    notifiers:
      - alice_alert  # название, которые указали выше

Будильники

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

• У каждой станции есть объект calendar, отключен по умолчанию. Вам нужно включить его вручную для требуемых станций
• Календари поддерживают триггеры "за Х минут до начала события"
• Будильник может быть установлен либо на определённую дату/время, либо на еженедельные повторения по определённым дням. Будильник может быть отключен
• Будильники синхронизируются раз в минуту
• Триггеры будильников синхронизируются раз в 15 минут (ограничение HA)

Возможности локальных колонок

Третий способ вызвать TTS

Только для локального режима!

Продолжает слушать после произнесения текста! Нет ограничения на количество символов. Поддерживает спецэффекты.

script:
  yandex_tts4:
    alias: TTS только для локального режима
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: <speaker effect="megaphone">Объявление погоды на сегодня...
        media_content_type: dialog

Громкость TTS

Только для локального режима!

Колонка произнесёт текст с заданной громкостью и вернёт громкость на прежний уровень.

script:
  alice_custom_volume1:
    sequence:
    - service: tts.yandex_station_say
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        message: Внимание! Важное сообщение...
        options:
          volume_level: 0.8

Или так

script:
  alice_custom_volume2:
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: Внимание! Важное сообщение...
        media_content_type: text  # поддерживается text и dialog
        extra:
          volume_level: 0.8

Стриминг музыки

Только для локального режима!

Поддерживается стриминг (трансляция) музыки с колонки Яндекса на умные колонки других производителей. Условия такие:

• Нужна Яндекс колонка с поддержкой локального управления. Яндекс Модули функцию НЕ поддерживают.
• Нужна подписка Яндекса на музыку.
• Сторонняя колонка должна иметь интеграцию в Home Assistant с поддержкой потокового воспроизведения музыки. Если она умеет функцию "воспроизвести текст" из окна медиа-плеера, то поддержка скорее всего есть.
• Синхронизовать колонки разных производителей в идеальный мультирум нереально, поэтому звук на колонке Яндекса во время трансляции приглушается. Но при общении с Алисой звук временно возвращается.
• Громкость колонки Яндекса также синхронизируется с внешней акустикой.
  • Опционально синхронизацию громкости можно отключить (sync_volume: False)
  • Опционально можно использовать Jinja2-шаблон для настройки произвольного соответствия громкости (sync_volume: "{{ volume_level / 2 }}")

Протестирована поддержка интеграций:

• Chromecast:
  • колонки с Google Assistant
  • медиаплееры/телевизоры/проекторы на Android TV
• DLNA:
  • саундбар Samsung HW-MS6500
  • саундбар Yamaha YAS-306
  • телевизор Philips 2011 года
  • телевизоры Samsung Tizen 2016+ год
• Kodi
• MPD
  • MPD for Windows
  • Xiaomi Gateway EU
• SamsungTV
  • телевизоры Samsung Tizen 2016+ год
  • важно указать в конфиге media_content_type: url
• Sonos
• Yamaha MusicCast

Внимание. Для корректной работы некоторых интеграций, ваш сервер ХА должен быть доступен в локальной сети по протоколу HTTP и IP-адресу:

Настройки > Общие > URL-адрес для домашней сети > http://192.168.1.123:8123/

Стоит понимать, что при правильной настройке внешнего доступа через различные аддоны, вы можете пользоваться ХА по адресу вида https://myhome.duckdns.org/. И при правильной настройке такая ссылка будет работать как во внешней, так и в локальной сети. А ссылка вида HTTP/IP будет использоваться только локальными медиа-плеерами.

Компонент автоматически найдёт все теоретически подходящие media_player и добавит их в список source_list у колонки. При желании вы можете вручную указать список колонок в configuration.yaml:

yandex_station:
  media_players:
    - entity_id: media_player.yas_306
      name: Yamaha
    - entity_id: media_player.mpd
      name: MPD
      speaker_id: [media_player.yandex_station]  # опциональная привязка к конкретным колонкам Яндекса
    - entity_id: media_player.yas_306
      name: Yamaha (no sync)
      sync_volume: False                         # опциональное отключение синхронизации громкости звука
    - entity_id: media_player.yas_306
      name: Yamaha (no sync)
      sync_volume: "{{ volume_level / 2 }}"      # использование Jinja2 для синхронизации громкости
    - entity_id: media_player.samsung
      name: SamsungTV
      media_content_type: url                    # важно для интеграции SamsungTV из HACS
    - entity_id: edia_player.nest_hub
      name: Chromecast
      quality: lossless                          # варианты качества - lossless / nq / lq
      codecs: flac-mp4,aac-mp4,mp3               # поддерживаемые кодеки - flac,aac,mp3,flac-mp4,aac-mp4

Выбор качества трансляции:

• По умолчанию выбрано качество lossless + mp3 = 320 kbpm
• Опционально можно изменить и качество и поддерживаемые кодеки
• Не стоит выбирать только flac-mp4 - не все песни есть в этом формате
• Не все плееры умеют все форматы, например Yamaha YAS-306 не умеет AAC
• Где-то с апреля 2025 в Яндекс.Музыке форматы flac и aac были заменены форматами flac-mp4 и aac-mp4

Вы можете переключать трансляцию через:

• Переключатель source в карточке Mini Media Player
• Переключатель source в стандартном окне медиа-плеера колонки
• Сервис media_player.select_source
• Получение команд от станции, например на фразу "Алиса, включи трансляцию на Ямаху"
• Интеграцию колонок в умный дом Яндекса, единственное ограничение - вместо нормальных названий источников там будет "один", "два", "три"...
• Интеграцию колонок в HomeKit

Караоке

Только для локального режима!

Для каждой колонки создаётся camera (выключена по умолчанию), которая может отображать текст текущей песни в режиме караоке.

Поток с текстом можно отправить на телевизор, например Chromecast:

alias: Включить караоке на ТВ
sequence:
  - service: media_player.play_media
    target:
      entity_id: media_player.mibox
    data:
      media_content_id: >-
        http://192.168.1.123:8123/api/camera_proxy_stream/camera.hall_speaker_lyrics?token={{ state_attr('camera.hall_speaker_lyrics', 'access_token') }}
      media_content_type: image/jpeg

Проигрывание медиа по ссылкам

Только для локального режима!

Поддерживаются только ссылки, которые умеют устройства Яндекса!

• Песня на Яндекс.Музыке - пример
• Альбом на Яндекс.Музыке - пример
• Исполнитель на Яндекс.Музыке - пример
• Плейлист на Яндекс.Музыке - пример
• Аудиокнига на Яндекс.Музыке - пример
• Аудиокнига на Яндекс.Книгах - пример

Только на устройствах с экраном (большая Станция или Модуль)

• YouTube - пример
• Кинопоиск - пример
• Кинопоиск HD - пример

Это работает в том числе из GUI, если вставить ссылку в поле "воспроизвести текст".

script:
  yandex_play_url:
    alias: Проигрывание медиа по ссылке
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: https://music.yandex.ru/album/2150009/track/19174962
        media_content_type: xxx  # тип не важен, но должен быть!

Проигрывание локальной музыки

Только для локального режима!

Аналогично функции проигрывание медиа по ссылкам, но поддерживаются ссылки на любые файлы форматов AAC/FLAC/MP3 или потоковую музыку (радио) форматов AAC/HLS/MP3.

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

Желательно, чтоб в ссылке было имя формата (.mp3, .m3u8 и тп). Если его не будет - компонет попытается угадать формат из Content-Type. При необходимости - вы сами можете указать формат через media_content_type: stream.mp3.

Файл можно загрузить и запустить из Медиа библитеки Home Assitant:

• карточка медиа плеера колонки - Browse Media
• раздел левого меню веб-интерфейса - Media
• папка /media на диске

Так же поддерживается воспроизведение файлов и потоковой музыки (радио) из Music Assistant.

Анимация на экране колонки

Только для локального режима!

На данный момент поддерживаются колонки Макс (с экраном) и Мини 2 (с часами). Колонки Лайт 2, Миди, Мини 3 - НЕ поддерживаются.

Для Станции Макс поддерживается отправка анимации в формате GIF:

• обязательно 25х16 пикселей
• обязательно чёрно-белое изображение (256 градаций серого для управления яркостью светодиодов)
• обязательно с выключенными опциями оптимизации GIF, в FFmpeg такие опции называются offsetting и transdiff

Пример как конвертировать анимацию любого входного формата с помощью FFmpeg:

ffmpeg -i input.mp4 -vf "format=gray,scale=25:16:force_original_aspect_ratio=1,pad=25:16:(ow-iw)/2:(oh-ih)/2,setsar=1" -y -gifflags -offsetting-transdiff output.gif

Запуск анимации полностью аналогичен функции проигрывание локальных MP3, только формат не mp3, а gif.

Важно. Колонка кеширует изображение по ссылке. И если вы измените файл, но не измените ссылку - колонка отобразит старую анимацию. В ссылку на изображение можно добавлять любые query-параметры для обхода проблемы кеша (например .gif?12345...).

Для Станции Мини 2 всё немного сложнее. Необходимо описывать анимацию специальным кодом:

action: media_player.play_media
data:
  media_content_id: 00 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 03 E8
  media_content_type: draw_animation
target:
  entity_id: media_player.yandex_station  # замените на вашу колонку

У колонки есть 32 управляемых светодиода. Для контроля которыми используется 35 чисел в 16-ричном формате. Первое число всегда 00. Последние два числа это задержка отображения кадра в миллисекундах (0x03E8 = 1000мс = 1сек). Остальные числа это яркость светодиода (00 - выключен, FF - максимальная яркость). Для анимации просто указывайте кадры один за другим подряд. Пробелы игнорируются.

Пользователь Alex сделал такой редактор анимации. "Файл > Создать копию" для возможности редактировать.

Получение ответов от колонки

Только для локального режима!

Внимание: Примерно до лета 2024 колонка возвращала текстовый ответ на любой запрос. После очередного обновления в Яндексе колонка стала возвращать текстовый ответ только на ограниченный перечень фраз (погода, время, умный дом и тп.).

Вариант 1. Через службу yandex_station.send_command.

script:
  example1:
    sequence:
      - action: yandex_station.send_command
        data:
          entity_id: media_player.yandex_station  # замените на вашу колонку
          text: какая погода?
        response_variable: response
      - action: notify.persistent_notification
        data:
          message: "{{ response }}"

Вариант 2. Через Conversation Entity.

• Доступно в Home Assistant версии 2024.5 и выше.
• Такой объект есть у каждой колонки, но он выключен по умолчанию!
• Можно использовать в качестве стандартной диалоговой системы Conversation (подробнее)

script:
  example2:
    sequence:
      - action: conversation.process
        data:
          agent_id: conversation.yandex_station_mini  # замените на вашего агента
          text: какая погода?
        response_variable: response
      - action: notify.persistent_notification
        data:
          message: "{{ response }}"

Яндекс Алиса в Telegram

Только для локального режима!

Вы можете общаться со своей Алисой через Telegram. И она вам будет отвечать в Telegram! Можете спросить погоду, вызвать такси, включить песню, поиграть в города или управлять вашим умным домом (если настроили интеграцию с умным домом Яндекса). Никаких слеш-команд Telegram, общайтесь с Алисой обычным текстом.

При этом Home Assistant не обязательно "прокидывать" в Интернет. Telegram в режиме polling может работать без внешнего доступа.

При этом проигрывание медиа по ссылкам тоже будет работать. Просто поделитесь со своим Telegram ботом ссылкой на фильм Кинопоиска, ролик YouTube или песню/альбом/плейлист на Яндекс Музыке - и они запустятся на вашей колонке!

telegram_bot:
- platform: polling
  api_key: TELEGRAM_BOT_API_KEY  # создайте своего Телеграм бота
  allowed_chat_ids:
  - TELEGRAM_USER1_ID  # укажите ID своего аккаунта
  - TELEGRAM_USER2_ID  # при желании, поддерживается несколько аккаунтов

automation:
- trigger:
    platform: event
    event_type: telegram_text
  action:
  - service: conversation.process
    data:
      agent_id: conversation.yandex_station_mini  # замените на вашу станцию
      text: "{{ trigger.event.data.text }}"
      conversation_id: "{{ trigger.event.data.chat_id }}"
    response_variable: response
  - service: telegram_bot.send_message
    data:
      target: "{{ trigger.event.data.chat_id }}"
      message: "{{ response.response.speech.plain.speech }}"

Для отправки Telegram сообщений разным станциям @ProstoMaksks предложил такое решение.

Список покупок

Только для локального режима!

Поддерживается двухсторонняя синхронизация списка покупок Алисы и стандартного компонента Shopping List и To-do list. Благодаря интеграции To-do list можно синхронизировать списки из других сервисов, например Google Tasks или Todoist. Можно добавлять и удалять элементы списка как из ХА, так и голосом с колонки.

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

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

script:
  update_shopping_list:
    alias: Обновить список покупок
    sequence:
      - service: media_player.play_media
        entity_id: media_player.yandex_station_mini  # замените на вашу колонку
        data:
          media_content_id: update
          media_content_type: shopping_list

Для использования интеграции To-do list в media_content_id необходимо указать entity_id списка, который требуется синхронизировать (например todo.shopping_list, todo.google_tasks или todo.todoist).

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

Или вы можете отмечать элементы как завершенные в интерфейсе ХА. Такие элементы будут удалены из Яндекса при следующей синхронизации. Только не очищайте вручную список завершенных элементов в ХА до синхронизации! Иначе синхронизация нарушится.

Синхронизация происходит по следующим правилам:

1. Завершенные (отмеченные) элементы списка ХА - удаляются из Яндекса (если они там были)
2. Новые элементы, созданные именно из ХА - добавляются в Яндекс (если их там не было)
3. Список ХА полностью заменяется тем, что получилось в Яндексе после 1 и 2
4. Список завершенных элементов ХА очищается

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

Статический IP для колонки

Только для локального режима!

Проще всего проверить работу локального режима - запустить на колонке песню и посмотреть, отображается ли обложка в Home Assistant.

Локальные устройства ищутся автоматически по протоколу mDNS (zeroconf). Он не будет работать, если вы открыли только один порт для Home Assistant. Например, установка в Docker (в Hass.io всё хорошо) без настройки network=host или виртуальная машина с NAT.

Если у вас есть с этим какие-то проблемы - можно указать для колонок статический IP-адрес на роутере и в конфиге Home Assistant. device_id вашей колонки можно посмотреть в мобильном приложении Яндекса.

yandex_station:
  devices:
    12345678901234567890:  # device_id вашей колонки
      host: 192.168.1.123
      name: Яндекс Станция  # имя можно задать и тут

Прочие функции

Управление умным домом Яндекса

• В конфиге нужно указать, какие устройства умного дома с Алисой необходимо добавить в Home Assistant
• Большинство типов устройств поддерживаются напрямую:
  • климат: Кондиционеры (добавленные как через ИК-пульт, так и напрямую), Обогреватели, Очистители, Термостаты, Увлажнители
  • медиа: Телевизоры (добавленные как через ИК-пульт, так и напрямую), ИК-пульты
  • свет
  • датчики (сенсоры)
  • выключатели и розетки
  • пылесосы
  • чайники
  • шторы
  • камеры и домофоны
• Также любые устройства можно собрать из простых элементов (switch, sensor, select, number)

НЕ ПОДДЕРЖИВАЮТСЯ устройства с событиями вместо состояний. Например, нажатие на кнопку или движение (по датчику PIR) это события. А температура или режим работы - это состояния.

В качестве ИК-пультов можно использовать Яндекс Пульт или более дешевую версию от Tuya (добавляется напрямую как родной пульт Яндекса).

В конфиге нужно перечислить имена ваших устройств:

yandex_station:
  include:
    - Кондиционер                                                 # добавить ВСЕ устройства с этим именем
    - name: Очиститель Xiaomi
      properties: [ "temperature", "humidity", "pm2.5_density" ]  # опционально создать сенсоры
    - name: Чайник Polaris
      capabilities: [ "mute", "keep_warm" ]                       # опционально создать контролы
    - name: Увлажнитель Polaris
      capabilities: [ "mute", "controls_locked", "ionization", "backlight" ]  # опционально создать контролы
      properties: [ "temperature","humidity" ]                                # опционально создать сенсоры
    - name: Кондиционер
      room_name: Зал                                              # опционально указать комнату
      capabilities: [ "temperature", "fan_speed", "thermostat" ]  # опционально создать контролы
      current_temperature: "{{ states('sensor.temperature') }}"   # опционально указать сенсор температуры
    - name: Увлажнитель
      current_humidity: "{{ states('sensor.humidity') }}"         # опционально указать сенсор влажности
    - room_name: Ванная                                           # добавить ВСЕ устройства из этой комнаты
    - type: devices.types.sensor                                  # добавить ВСЕ устройства такого типа
    - id: 96581cf1-dad4-4329-bbe9-0c843128f60a                    # добавить устройство по ID

Кондиционер будет добавлен как термостат:

Настроенное вручную ИК-устройство будет добавлено как Remote. Команды отправляются через сервис remote.send_command. Можно отправить несколько команд за раз, настроить задержку и количество повторов. Пример вызова.

Изменение настроек Алисы

script:
  change_settings:
    alias: Изменение настроек Алисы
    sequence:
      - service: media_player.play_media
        data:
          entity_id: media_player.yandex_station  # замените на любую вашу колонку
          media_content_id: 'без лишних слов: да'  # пробел после двоеточия
          media_content_type: settings

Поддерживаемые значения:

• без лишних слов: да/нет
• ответить шепотом: да/нет
• анонсировать треки: да/нет
• скрывать названия товаров: да/нет
• звук активации: да/нет
• одним устройством: да/нет
• понимать детей: да/нет
• рассказывать о навыках: да/нет
• взрослый голос: умеренный/семейный/безопасный/без ограничений
• детский голос: безопасный/семейный
• имя: алиса/яндекс
• адаптивная громкость: да/нет
• кроссфейд: да/нет

Изменение языка Алисы

Переключение выбранной колонки на другие языки. Начинает отзываться на Ясмина!

action: media_player.play_media
target:
  entity_id: media_player.hall_speaker  # замените на вашу колонку
data:
  media_content_type: locale
  media_content_id: ru-RU               # ru-RU en-US ar-SA kk-KZ tr-TR

Несколько TTS в конфиге

Если в Home Assistant подключены несколько TTS-сервисов - из карточки медиа-плеера будет вызываться самый первый из них (сортировка по имени). Например, tts.google_translate_say будет приоритетнее tts.yandex_station_say. А tts.yandex_station_say будет приоритетнее tts.yandextts_say.

Компонент Яндекс.Станции умеет поддерживать другие TTS, а вот другие колонки могут не поддерживать TTS yandex_station_say. При необходимости вы можете:

• отключить ненужные TTS в конфиге ХА
• использовать mini-media-player, где можно указать имя TTS-сервиса для каждой колонки
• изменить название TTS-сервиса:

yandex_station:
  tts_service_name: alice_say

Звук Яндекс.Станции по HDMI

Только для станций с HDMI

Функция переключения выхода звука находится у Яндекса в бете. На телевизор выводится только звук видео (например YouTube). Звук музыки и голос Алисы остаются на Станции.

Раньше функция включалась в конфиге. Теперь включена по умолчанию для всех владельцев больших Станций.

script:
  yandex_hdmi_sound:
    alias: Звук Станции на HDMI
    sequence:
    - service: media_player.select_source
      entity_id: media_player.yandex_station  # поменяйте на вашу станцию
      data:
        source: HDMI

Управление яркостью экрана станции Макс

Только для Яндекс.Станции Макс

script:
  yandex_brightness:
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station_max
      data:
        media_content_id: 0.5  # допустимые значения от 0 до 1, или -1 для включения авто режима
        media_content_type: brightness

Если Яндекс заблокирован в стране

#257 #263 #518 #552

Использование другого домена Яндекса

yandex_station:
  domain: yandex.com

Подключение HTTP-прокси

yandex_station:
  proxy: http://username:[email protected]:3128

Отключение проверки HTTPS сертификатов

yandex_station:
  ssl: False

Troubleshooting

Поиск и устранение проблем

1. Посмотрите лог Home Assistant на наличие ошибок интеграции Yandex.Station.
2. Если в логе есть ошибка, постарайтесь прочитать её. Среди непонятных букв может быть прямой ответ на проблему на русском или английском языке.
3. Поищите похожую ошибку на GitHub проекта (включая закрые issue).
4. Если ошибки нет, можно включить отладочные логи интеграции и посмотреть, что проиходит там.

   logger:
     default: info
     logs:
       custom_components.yandex_station: debug
   

5. Если самостоятельно не справились - переходите по ссылке в пункте 3 и подробно опишите проблему. Обязательно приложите ошибку из лога, если она есть. При наличии чего-то полезного в пункте 4, приложите и этот лог.

Полезные автоматизации

• Отображаем статус Яндекс Станции с помощью умных ламп, так же эту автоматизацию можно переделать в "Приглушаем звук телевизора, когда Алиса слушает", Только для локального режима!
• Звонок на колонку с Алисой
• Перехват фраз с локальных колонок, Только для локального режима!
• Отвечать на intents с последней активной колонки, Только для локального режима!
• Управление разными станциями из Telegram, Только для локального режима!
• Действие по таймеру в Яндекс Алисе
• Список радиостанций для колонок Яндекса

Полезные ссылки

• https://github.com/sergejey/majordomo-yadevices
• https://github.com/anVlad11/dd-alicization