Yandex.Station for Home Assistant

Компонент для управления Яндекс.Станцией по локальной сети.

• CHANGELOG

На середину февраля 2020 поддерживается:

• Яндекс.Станция (большая)
• Яндекс.Модуль (у меня нет, но по отзывам работает)

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

• Яндекс.Станция Мини
• Irbis
• Dexp

Колонки не поддерживаются на стороне Яндекса. Если на колонку "прилетит" новая прошивка с поддержкой управления - она с высокой вероятностью "подхватится" без доработки компонента.

Возможности:

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

Настройка

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

Токен сохраняется в директории конфигов и больше не запрашивается.

yandex_station:
  username: myuser
  password: mypass

Если знаете свой Oauth-токен, можно так:

yandex_station:
  token: abcdefghijklmnopqrstuvwxyz

Пример использования

script:
  # TTS зависит от настройки "Режим звука"! (произнести или выполнить команду)
  yandex_tts:
    alias: TTS на Яндекс.Станции
    sequence:
    - service: tts.yandex_station_say
      data_template:
        entity_id: media_player.yandex_station_12345678901234567890
        message: Температура в комнате {{ states("sensor.temperature_hall")|round }} градуса.

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

  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

  yandex_hdmi_sound:
    alias: Звук Станции на HDMI
    sequence:
    - service: media_player.select_source
      data:
        entity_id: media_player.yandex_station_12345678901234567890
        source: HDMI

Для шаблонов не забывайте указывать data_template, для остальных команд хватит просто data.

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

Продвинутое использование TTS

script:
  # TTS не зависит от настройки "Режим звука"! и всегда будет произносить фразу
  yandex_tts2:
    alias: TTS на Яндекс.Станции
    sequence:
    - service: media_player.play_media
      data:
        entity_id: media_player.yandex_station_12345678901234567890
        media_content_id: Повторяю вашу фразу
        media_content_type: text

  # TTS не зависит от настройки "Режим звука"! и будет продолжать слушать после
  # произнесения фразы
  yandex_tts3:
    alias: TTS на Яндекс.Станции
    sequence:
    - service: media_player.play_media
      data:
        entity_id: media_player.yandex_station_12345678901234567890
        media_content_id: Мне следует пропылесосить?
        media_content_type: dialog

В режиме media_content_type: dialog поддерживаются:

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

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

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

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

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

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

Продвинутое использование команд

Компонент создаёт сервис yandex_station.send_command, которому необходимо передать команду.

Полезные команды станции можно узнать тут.

Самая универсальная - это sendText. Станция выполнит посланную фразу, как буд-то услышала команду голосом.

Выбрать станцию можно указав entity_id или device (для обратной совместимости). В качесте device может быть название станции или идентификатор. Можно посмотреть в приложении Яндекс или в веб интерфейсе.

Если станция одна - можно ничего не указывать.

script:
  yandex_tts:
    alias: TTS на Яндекс.Станции
    sequence:
    - service: yandex_station.send_command
      data:
        entity_id: media_player.yandex_station_12345678901234567890
        command: sendText
        text: Повтори за мной 'Привет, человек!'

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

Я решил не включать эту функцию в базовую конфигурацию. Она использует совсем другие API Яндекса и требует дополнительной авторизации в сервисах Яндекса.

Сама функция переключения выхода звука находится у Яндекса в бете. В отличии от обычного управления станцией - функция меняет её настройки. Поэтому пользуйтесь на свой страх и риск.

Включается в файле конфигурации:

yandex_station:
  username: myuser
  password: mypass
  control_hdmi: true

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

TTS Яндекса работает только с их колонками и не работает с другими, например Google Mini. Так и другие TTS не работают с колонками Яндекса.

В этом случае вы можете настроить несколько TTS сервисов. Из окна медиа плеера всех колонок всегда будет стартовать первый повавшийся сервис (в алфавитном порядке). Поэтому название TTS сервиса Яндекса можно переименовать, например, в alice_say (слово say на конце обязательно!).

yandex_station:
  username: myuser
  password: mypass
  tts_service_name: alice_say

tts:
- platform: google_translate
  language: ru

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

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