Music yandex station: Яндекс.Музыка

Слушать Яндекс.Музыку и радио — Станция. Справка

1. Синхронизация с приложением Яндекс.Музыки
2. Стереопара

На Станции вам доступна вся библиотека Яндекс.Музыки: более 40 млн композиций различных жанров, стилей и эпох. Попросите Алису включить нужную музыку и управляйте воспроизведением.

Подробнее читайте в справочнике голосовых команд.

Если не хотите выбирать, что слушать — скажите: «Алиса, включи радио». FM-потоки транслируются через Яндекс.Музыку. Зона вещания радиостанций ограничена их лицензиями. Все голосовые команды и список доступных радиостанций можно посмотреть на странице Слушать радио.

• листать треки, включать поток по треку, менять плейлист, перемешивать треки;

• изменять громкость;

• ставить лайки;

• видеть, что проигрывается на вашей колонке, останавливать воспроизведение.

Примечание. Управление воспроизведением доступно в приложении Яндекс.Музыки версии 541 и новее для iOS или 2021.08.1 и новее для Android. Если у вас установлено более старое приложение, обновите его.

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

1. В правом верхнем углу нажмите .

2. При необходимости разрешите поиск устройств в локальной сети — это нужно, чтобы приложение могло найти устройства в сети Wi-Fi.

3. Выберите нужное устройство.

   Как это выглядит

   Если на панели нет нужного устройства, воспользуйтесь рекомендациями в разделе Решение проблем.

Вы можете получить объемный звук, объединив две одинаковые колонки в стереопару.

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

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

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

Новые фичи в версии 2.0:

• Поддержка всех колонок через облачное управление (не все протестированы!)
• Одновременное управление колонками по локальной сети и через облако
• Проигрывание медиа по ссылкам (подробнее)
• Яндекс Алиса в Telegram (подробнее)

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

Список устройств

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

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

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

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

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

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

Карточка Яндекс Станции

Обложки работают только при локальном управлении

Карточка Яндекс Мини

Демо

Вопросы и ответы

В.

Установка

Способ 1. HACS

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

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

Настройка

Способ 1. GUI (рекомендуется)

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

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

Для авторизации используйте ваши Логин и пароль Яндекса или одноразовый пароль из приложения Яндекс. Ключ, при включенной двухфакторной авторизации.

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

Если Яндекс посчитает авторизацию подозрительной — он может потребовать ввести капчу или подтвердить ваш аккаунт в сервисе Яндекс Паспорт. Подтверждать аккаунт необходимо используя тот же Интернет/VPN, что и сервер Home Assistant.

В случае проблем с авторизацией по паролю, можно зайти в Яндекс в обычном браузере и скопировать оттуда Cookies. Компонент подскажет что нужно сделать на этапе настройки.

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

Способ 2. YAML (устаревший)

yandex_station:
  username: myuser
  password: mypass

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

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

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

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

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

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

Зависит от настройки «Режим звука» (из окна медиа-плеера). Будет или произносить текст или выполнять команду. Он же вызывается из окна медиа-плеера.

Из-за зависимости от «Режим звука» — не рекомендуется к использованию в автоматизациях. Используйте Второй способ.

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

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

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

Не зависит от настройки «Режим звука».

Внимание. Команда всегда отправляется через облако, даже на локальный колонках, потому что это единственно известный способ, чтоб станция НЕ продолжала слушать после TTS.

В облачном режиме есть два ограничения:

• Команда Алисе может содержать только кириллицу, латиницу, цифры и спецсимволы: «-,!.:=?».
• Команда Алисе должна быть не длиннее 100 символов

Компонент автоматически удалит из текста запрещенные символы и ограничит длину текста до допустимой.

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

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

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

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

script:
  yandex_tts3:
    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_template:
        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

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

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

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

script:
  yandex_tts4:  # работает и в локальном и в облачном режиме
    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

Другие голоса

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

Можно использовать не только голос Алисы. Разные голоса можно посмотреть тут.

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

script:
  yandex_tts5:  # работает и в локальном и в облачном режиме
    alias: другой голос TTS
    sequence:
    - service: media_player.play_media
      entity_id: media_player.yandex_station  # замените на вашу колонку
      data:
        media_content_id: <speaker voice="zahar">Всем привет. Меня зовут Захар...
        media_content_type: dialog

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

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

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

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

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

Это работает в том числе из 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  # тип не важен, но должен быть!

Яндекс Алиса в 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: media_player. play_media
    entity_id: media_player.yandex_station_mini  # замените на вашу станцию
    data_template:
      media_content_id: "{{ trigger.event.data.text }}"
      media_content_type: "question:{{ trigger.event.data.chat_id }}"
- trigger:
    platform: event
    event_type: yandex_station_response
  action:
    service: telegram_bot.send_message
    data_template:
      target: "{{ trigger.event.data.request_id }}"
      message: "{{ trigger.event.data.text }}"

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

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

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

Вы можете общаться со своей Алисой через GUI Home Assistant (lovelace). Это работает в любом браузере на любой платформе, включая смартфоны и официальные мобильные приложения.

При включении компонента Conversation в правом верхнем углу интерфейса Home Assistant появляется микрофон. Сам компонент позволяет общаться в режиме диалога.

Работает аналогично добавлению Алисы в Телеграм. Вы фактически общаетесь в текстовом режиме с одной из ваших колонок. Отправка ссылок на медиа тоже работает!

conversation:
  intents:
    # менять нужно entity_id до двоеточия, после двоеточия ничего менять не надо!
    media_player.yandex_station_mini: [.+]  # замените на вашу станцию

Компонент поддерживает не только текстовый, но и голосовой ввод при следующих условиях:

• Home Assistant открыт в браузере Google Chrome на Windows, macOS, Linux, Android или в мобильном приложении Android — потому что для распознования голоса используются API Google
• Home Assistant открыт по HTTPS-ссылке или localhost-ссылке — потому что микрофон в браузере Google Chrome доступен только в этом случае

По умолчанию в Home Assistant включен голосовой ввод только на английском языке. Чтоб это исправить — добавьте в конфиг такую настройку. Если у вас голосовой ввод не работает или он вам не нужен — настройку добавлять не надо! Общаться текстом с Алисой вы можете и без неё. После изменения вероятно потребуется сбросить кэш браузера (включая cookies and other site data).

yandex_station:
  recognition_lang: ru-RU

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

Морфология числительных

Для правильного произношения числительных в TTS, ознакомьтесь с другим моим компонентом — MorphNumbers.

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

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

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

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

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

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

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

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

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

Предварительно необходимо добавить стандартный компонент, через 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

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

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

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

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

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

Внешний вид

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

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

entity: media_player.yandex_station_mini  # поменяйте на вашу колонку
artwork: cover
sound_mode: icon
shortcuts:
  attribute: sound_mode
  buttons:
    - icon: 'mdi:account-voice'
      id: Произнеси текст
      type: sound_mode
    - icon: 'mdi:robot'
      id: Выполни команду
      type: sound_mode
    - icon: 'mdi:playlist-star'
      id: включи мою любимую музыку вперемешку
      type: command
    - icon: 'mdi:playlist-music'
      id: включи плейлист дня
      type: command
    - icon: 'mdi:heart'
      id: лайк
      type: command
    - icon: 'mdi:heart-off'
      id: снять лайк
      type: command
  columns: 6
hide:
  sound_mode: false
  runtime: false
tts:
  platform: yandex_station
type: 'custom:mini-media-player'

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

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

Компонент создаёт сервис 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

Только для станций с 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

Статический IP для локального режима

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

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

Локальные устройства ищутся автоматически по протоколу mDNS (zeroconf). Если у вас есть с этим какие-то проблемы — можно указать для них статический IP адрес на роутере.

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

В конфиге нужно указывать device_id вашей колонки. Он есть на конце entity_id после media_player.yandex_station_. Ещё его можно посмотреть в debug логах компонента и в мобильном приложении Яндекса.

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

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

Новый способ

1. Создайте новый Сценарий в интерфейсе Яндекса.
2. Укажите нужные фразы активации в разделе Если
3. Выберите «Любая умная колонка» в разделе То

Если хотите, чтоб Алиса сразу же что-то сделала или сказала — выберите Выполнить команду или Прочитать текст. Если хотите, чтоб команда бесшумно ушла в ХА — укажите выполнить команду Сделай громче на 0. Такие команды колонка выполняет бесшумно и по факту громкость не меняется.

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

instance: text_action      # text_action при "выполнить команду", phrase_action при "прочитать текст"
value: Сделай громче на 0  # фраза колонке из раздела То
name: Яндекс Мини          # имя колонки в ХА
entity_id: media_player.yandex_station_mini  # ID колонки в ХА

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

alias: Расскажи шутку
trigger:
  - platform: event
    event_type: yandex_speaker
    event_data:
      value: Сделай громче на 0  # фраза из Сценария Яндекса (раздел То) 
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

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

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

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

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

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

Устаревший способ, только для продвинутых пользователей

Для работы функционала должна быть настроена интеграция Home Assistant с умным домом Яндекса!

1. Настройте список фраз, на которые ваши станции должны реагировать и ответы на них. Если не хотите ответ — оставьте его пустым (двоеточие обязательно). При первом запуске компонент создаёт служебный медиа-плеер media_player.yandex_intents.
2. Синхронизируйте ваши устройства в мобильном приложении Яндекса, чтоб этот плеер появился и там. Не нужно его переименовывать и перемещать в комнаты.
3. Перезапустите Home Assistant. В мобильном приложении Яндекса должны появиться ваши сценарии.

В ответ на эти фразы в Home Assistan будет генерироваться событие типа yandex_intent с произнесённым текстом. Теперь можете писать свои автоматизации на YAML или Node-RED.

yandex_station:
  username: myuser
  password: mypass
  intents:
    Покажи сообщение: ага
    Какая температура в комнате:
    Какая влажность в комнате:

automation:
- trigger:
    platform: event
    event_type: yandex_intent
    event_data:
      text: Покажи сообщение
  action:
    service: persistent_notification.create
    data:
      title: Сообщение со станции
      message: Шеф, станция чего-то хочет

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

На данный момент поддерживаются:

• Кондиционеры — добавленные как через ИК-пульт, так и напрямую (например LG с Wi-Fi)
• Телевизоры — добавленные как через ИК-пульт, так и напрямую
• Обученные вручную ИК-команды — обученные вручную команды ИК-пульта (Пульт => Добавить устройство => Настроить вручную)
• Розетки — включая энергопотребление
• Лампочки — включая настройку яркости и цвета
• Обогреватели
• Пылесосы

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

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

yandex_station:
  username: myuser
  password: mypass
  include:
  - Кондиционер  # имя вашего кондиционера
  - Приставка  # имя не ИК-пульта, а устройства, настроенного вручную

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

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

script:
  volume_up:
    alias: Сделай громче
    sequence:
    - service: remote.send_command
      entity_id: remote.yandex_station_remote  # поменяйте на ваше устройство
      data:
        command: Сделай громче  # имя кнопки в интерфейсе
        num_repeats: 5  # (опционально) количество повторов
        delay_secs: 0.4  # (опционально) пауза между повторами в секундах
  turn_on:
    alias: Включи телевизор
    sequence:
    - service: remote.send_command
      entity_id: remote. yandex_station_remote  # поменяйте на ваше устройство
      data:
        command: [Включи, Смени вход, Ниже, Ниже, ОК]  # можно несколько кнопок
        delay_secs: 0.4  # (опционально) пауза между повторами в секундах

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

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

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

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

Несколько 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

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

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

node-red-contrib-yandex-station-management (node) — Node-RED

Local management of YandexStation using API on websockets

npm install node-red-contrib-yandex-station-management

Описание

С помощью модуля можно через локальное API управлять вопсроизведением на устройсвах Яндекса:

• Яндекс Станция(протестировано)
• Яндекс Станция мини(протестировано)
• Яндекс Станци Макс(протестировано)
• Яндекс Модуль(не протестировано)
• JBL Link Music(не протестировано)
• JBL Link Portable(протестировано)

Работа возможна только с устройствами, которые одновременно:

• подключены к учетной записи Яндекса
• находятся в одной локальной сети с сервером Node-Red

Для работы требуется токен от Яндекс. Музыки. В модуле в экспериментальном режиме реализована возможность получения токена из логин-пароля(Спасибо слать сюда). Если получение токена не отрабатывает, то стоит попробовать включить и отключить двух-факторную аутентификацию в настройках Яндекса. Источник. Убедиться в безопасности использования учетных данных можно посмотрев код

Второй из варинатов его получения описан в FAQ

Возможна работа с несколькими устройствами(протестировано) и несколькими учетными записями(протестировано).

Состоит из 4 нод, позволяющих гибко настраивать автоматизации и использовать голосовые уведомления:

• IN нода для автоматичесукого получения данных о статусе колонки
• GET нода для получения данных о статусе устройства по запросу.
• OUT нода для отправки команд станции
• Station нода для дополнительных настроек

Установка.

Установка проводится через раздел Manage Palette в Node-Red или при помощи npm. в каталоге с Node-Red (обычно ~/. node-red) выполнить команду:

npm i node-red-contrib-yandex-station-management

Первоначальная настройка.

После установки для начала работы добавить любую ноду, ввести учетные данные(токен) в раздел Login, сохранить и нажать Deploy(обязательно!). Как получить токен — написано в FAQ.

После деплоя в настройках ноды в поле Station должны появиться станции доступные для управления. Если станция не появилась в списке, то можно подождать пару минут или перезапустить Node-Red.

Описание возможностей и сценариев использования.

Нода Station

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

Connection to device

Управление подключением к станции. Если по каким-то причинам надо, чтобы подключение не производилось — выставить в Disabled.

Network

В состоянии Manual появляется возможность вручную указать адрес станции и порт для подключения. Рекомендуется, если используются docker-ы, HomeAssistant-ы, и прочие случаи, при которых не отрабатывает автоматические определение сетевых реквизитов для подключения.

Kid Control

Реализована возможность ограничения по времени для прослушивания песен, радио, сказок, чтобы маленькие любители ночных историй поскорее засыпали. Настраивается для каждого дня недели. Если не стоит галка Active, то для этого дня ограничения не работают. Phrase to say — фраза, которую скажет Алиса вместо музыки:) При этом работают навыки, будильники, погода, новости и так далее.

Нода IN.

Ставится на старте flow и автоматически отправляет данные о текущем статусе колонки в «сыром» формате и Homekit.

Full status Message(«сырой» формат)

Выдает данные без преобразования, то есть в том виде, в каком они получены от устройсва. Структура сообщения:

    {"aliceState":"IDLE",
    "canStop":false,
    "hdmi":
        {"capable":true,
        "present":false},
    "playerState":
        {"duration":180. 91,
        "extra":
            {"coverURI":"avatars.yandex.net/get-music-content/2383988/de45408f.a.9039208-1/%%",
            "stateType":"music"},
        "hasNext":true,
        "hasPause":false,
        "hasPlay":false,
        "hasPrev":true,
        "hasProgressBar":true,
        "liveStreamText":"",
        "progress":20,
        "showPlayer":true,
        "subtitle":"Крематорий",
        "title":"Мусорный ветер"},
        "playing":false,
        "timeSinceLastVoiceActivity":30454,
        "volume":0}

Сообщения от устройства могут приходить по несколько штук в секунду, поэтому стоит подумать о необходимости поставить штатную ноду RBE, чтобы фильтровать дубликаты по контенту(название трека(payload.playerState.title), имя исполнителя(payload.playerState.subtitle)).

HomeKit formatted

Внутри выполняется преобразование выдаваемого формата под homekit и ноду можно стыковать прямо с homekit-нодой, в результате чего значиьельно упрощается flow. Юзкейсы можно найти в конце документации.

Для homekit formatted выдачи имеются опции:

• Unique messages. Отправляются только уникальные сообщения, без дубликатов.
• Homekit format. Выбор вывода под разные устройства — Smart Speaker и Television. В примерах использования описаны сценарии.

Структура сообщения Homekit formatted — Smart Speaker:

{"CurrentMediaState":0,"ConfiguredName":"International String Trio - Tarantella"}

Структура сообщения Homekit formatted — Television:

{"Active":1}

При использовании устройства Television появляется возможность использования «пульта» на iOS.

Нода GET.

Ставится в середине flow и при любом входящем сообщении отправляет на выход в payload последний статус устройства. Структура выдачи аналогична Full status Message ноды IN.

Нода OUT.

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

Player command.

Управление воспроизведением колонки. Нода ждет, что в payload строкой придет одна из следующих команд: play, stop, next, prev, forward(вперед на 10 секунд), backward(назад на 10 секунд), volumeup, volumedown

Voice command.

Отправка команды, вместо того, чтобы говорить ее колонке голосом: «Включи свет», «Включи музыку», «Включи мой плейлист», «Отключись через 15 минут» и так далее.

TTS.

Воспросизведение голосом отправленных фраз — Text to Speech. Не имеет ограничения по символам. Есть ряд опций:

• Fixed volume level. Позволяет произносить фразу заданной громкостью. Если не выбрано, то фраза произносится с текущим уровнем громкости. После произнесения уровень громкости вернется в изначальный.
• Prevent listening. Если выбрано, то колонка после воспроизведения не «слушает», что ей ответят.
• Pause while TTS. Ставит воспроизведение плеера на паузу на время речи. Воспроизведение будет продолжено, только если что-то играло на момент поступления команды. Все опции комбинируемы между собой.

Работают голосовые спецэффекты,дополнительные голоса и звуки, при этом отправка производится в ввиде строки. Например, «смелость sil <[500]> город+а берёт»

Homekit Formatted.

Ловит вывод от Homekit от устройств SmartSpeaker(вкл/выкл) и Television(вкл/выкл + пульт) модуля NRCHB. Встроена функция проверки hap.context,предотвращающая зацикливание. Стыкуется напрямую с Homekit нодой. Опция «Default command» указывает, какую голосовую команду запустить, если нет текущего трека для старта воспроизведения, а играть что-то надо. Например, «Включи мою музыку» или «Включи детские песни».

RAW Command.

Получает сообщение в формате JSON внутри payload и передает его колонке без обработки. Возможна отправка нескольких сообщений в одном сообщении payload в виде массива. Известные команды:

1. Перемотка на позицию в секундах

   {
    "command": "rewind",
    "position" : 120
   }

2. Продолжить воспроизведение

   {
    "command": "play"
   }

3. Остановка вопроизведения

   {
    "command": "stop"
   }

4. Предыдущий трек

   {
    "command": "prev"
   }

5. Следующий трек

   {
    "command": "next"
   }

6. Включить исполнителя по ID

{
    "command": "playMusic",
    "id": "2",
    "type":"artist"
}

7. Включить трек по ID

   {
    "command": "playMusic",
    "id": "44731403",
    "type": "track"
   }

8. Включить плейлист по ID

   {
    "command": "playMusic",
    "id": "44731403:1234556",
    "type": "playlist"
   }

9. Установка громкости в диапазоне 0-1

   {
    "command" : "setVolume",
    "volume" : 0. 2
   }

10. Отправить «Текст» для TTS.

    {
    "command" : "sendText",
    "text" : "Повторяй за мной 'Текст'"
    }

11. Отправить голосовую команду.

    {
    "command" : "sendText",
    "text" : "Включи музыку"
    }

12. Прервать «слушание» после TTS и не только:

    {
    "command": "serverAction",
    "serverActionEventPayload": {
        "type": "server_action",
        "name": "on_suggest"
    }
    }

13. Отправить «Текст» для TTS со спецэффектами (raw режим):

    {
    "command": "serverAction",
    "serverActionEventPayload": {
        "type": "server_action",
        "name": "update_form",
        "payload": {
            "form_update": {
                "name": "personal_assistant.scenarios.repeat_after_me",
                "slots": [
                    {
                        "type": "string",
                        "name": "request",
                        "value": "<speaker effect='megaphone'>Ехал Грека через реку <speaker effect='-'>видит Грека в реке рак"
                    }
                ]
            },
            "resubmit": true
        }
    }
    }

• Изменение голоса

  "value": "<speaker voice='kostya'>смелость sil <[500]> город+а берёт"

  Поддерживаемые голоса: jane, oksana, omazh, zahar, ermil, levitan, ermilov, silaerkan, kolya, kostya, nastya, sasha, nick, erkanyavas, zhenya, tanya, anton_samokhvalov, tatyana_abramova, voicesearch, ermil_with_tuning, robot, dude, zombie, smoky, alyss, nick. (Список взят тут)

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

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

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

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

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

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

• Совмещение эффектов

  "value": "<speaker voice='kostya' audio='alice-sounds-game-win-1.opus' effect='megaphone'>добро пожаловать"

Stop listening.

Принудительное прерывания «слушания» Алисы при любом входящем в ноду сообщении. Аналогично 12 команде предыдущего раздела

Пример использования нескольких RAW команд

Остановить проигрывание музыки и сказать текст громкостью 0.8

[
    {"command":"stop"},
    {
        "command": "serverAction",
        "serverActionEventPayload": {
            "type": "server_action",
            "name": "on_suggest"
        }
    },
    {"command":"setVolume","volume":0. 8},
    {
        "command": "serverAction",
        "serverActionEventPayload": {
            "type": "server_action",
            "name": "update_form",
            "payload": {
                "form_update": {
                    "name": "personal_assistant.scenarios.repeat_after_me",
                    "slots": [
                        {
                            "type": "string",
                            "name": "request",
                            "value": "<speaker effect='megaphone'>Ехал Грека через реку <speaker effect='-'>видит Грека в реке рак"
                        }
                    ]
                },
                "resubmit": true
            }
        }
    }
]

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

Управление воспроизведением устройства.

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

1. Из Node-Red. В ноду OUT в режиме Player Command надо отправлять в виде строки одну из команд: play, stop, next, prev, forward, backward. Примеры идут вместе с плагином!
2. Из ui-dashboard. Благодарю участников сообщества Node-Red на sprut.ai за подгтовку примеров. Если плагин с дашбордом не стоит, его надо поставить. После этого имортировать пример из ноды и по адресу /ui найдутся элементы управления.

Есть еще один вариант от сообщества, который надо самостоятельно импортировать со страницы автора

Добавляется простым flow и выглядит отлично)

3. Из Homekit. Ноды IN и GET имеют возможность выдачи сообщений в готовом для Homekit формате. Можно самостоятельно подготовить сообщение к отправке в Homekit, а можно просто воспользоваться нужной настройкой внутри нод. Разумным будет установка галки Unique messages для IN-ноды, чтобы не заваливать Homekit одинаковыми сообщениями.

В списке устройств NRCHB есть Smart Speaker. Из коробки с помощью простого flow можно управлять состоянием вкл-выкл воспроизведения и видеть название трека. Работает только на iOS 14 или macOS Big Sur. Элементы управления внутри Homekit не работают, их еще не завезли Homekit-ноду.

Если требуется работать на старых версиях iOS/macOS или надо управлять воспроизведением со штатного инструмента Пульт из панели управления, то можно собрать flow на базе homekit-нод TV, ноды IN в соотвествующем формате и OUT. При этом OUT-нода в Homekit-формате умеет «понимать» вход от SmartSpeaker, Television и обоих вместе. Проверка сообщений на зацикливание встроена в ноду OUT.

FAQ.

Q:Как получить oAuth-токен?

A:Как один из вариантов — https://music-yandex-bot.ru

• Ввести свой логини и пароль
• Появится кнопка «Перейти в бота», ее не нажимать, а скопировать ссылку
• Внутри ссылки все буквы-цифры после &start= и есть токен

Q:Как получить обложку трека?

A: Ссылку на обложку Яндекс Музыки можно взять из статусного сообщения: payload.playerState.extra.coverURI

В начало добавить https:// а в конце вместо %% размер обложки, например 600×600. https://avatars.yandex.net/get-music-content/2383988/de45408f.a.9039208-1/600×600

Q:Как узнать ИД станции? Это может понадобиться,чтобы отличать станции, если их не одна.

A:Приложение Яндекс на телефоне — Устройства — Управление устройствами — Выбрать станцию — Дополнительная информация

Q:Почему название трека в Homekit меняется не сразу после переключения?

A: Это нормально, так как для отображния используется имя устройства, а изменения имен в Homekit отражаются, так как имеют наименьший приоритете перед статусами и состояниями.

Q: Элементы управления внутри Homekit «засерены» и не работают

A: Если используется тип устройства Smart Speaker, то да, там они не работают и я не нашел как сделать их активными. Если у кого-то получится их сделать активными, то создание issue поможет остальным. Сейчас альтернатива — это устройство ТВ и привязка к нему пульта. Получаетя как AppleTV. Пример есть внутри NRCHB

Q: После запуска Node-Red не видны устройство/устройства.

A: Такое случается, если устройсвта не найдены в сети. Стоит понимать, что протокол zeroconf, который используется для поиска выдает не стабильный результат. Один поиск из 5 заканчивается отсуствием найденных устройств. Как решение — просто подождать пару минут и повторный поиск найдет всех пропавших с радаров

Q: Как добавить пример из ноды?

A: В меню Node-Red есть пункт Import, а в нем раздел Examples. Внутри папки с названием плагина найдутся все примеры.

Команды для управления станции взяты тут. Спасибо автору.

ENG

Node-Red integration with Yandex Devices through websocket:

- Yandex Station(tested)
- Yandex Mini(tested)
- Yandex Station Max(tested)
- Yandex Module(not tested)
- JBL Link Music(not tested)
- JBL Link Portable(tested)

Installation

Run the following command in your Node-RED user directory - typically `~/.node-red`

npm i node-red-contrib-yandex-station-management

You need Yandex music token to work propertly.

yandex-music · PyPI

Делаю то, что по определённым причинам не сделала компания Yandex.

Маленькое сообщество разработчиков общаются и помогают друг другу в Telegram чатике, присоединяйтесь!

Начало работы

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

Инициализация клиента:

from yandex_music import Client

client = Client()

Для доступа к своим личным данным следует авторизоваться. Это можно осуществить через OAuth токен или логин с паролем.

Авторизация по логину и паролю:

from yandex_music import Client

client = Client.from_credentials('[email protected]', 'password')

Авторизация по токену:

from yandex_music import Client

client = Client('token')
# или
client = Client.from_token('token')

После успешного создания клиента Вы вольны в выборе необходимого метода из API. Все они доступны у объекта класса Client. Подробнее в методах клиента в документации.

Пример получения первого трека из плейлиста “Мне нравится” и его загрузка:

from yandex_music import Client

client = Client. from_credentials('[email protected]', 'password')
client.users_likes_tracks()[0].fetch_track().download('example.mp3')

В примере выше клиент получает список треков которые были отмечены как понравившиеся. API возвращает объект TracksList в котором содержится список с треками класса TrackShort. Данные класс содержит наиважнейшую информацию о треке и никаких подробностей, поэтому для получения полной версии трека со всей информацией необходимо обратиться к методу fetch_track(). Затем можно скачать трек методом download().

Пример получения треков по ID:

from yandex_music import Client

client = Client()
client.tracks(['10994777:1193829', '40133452:5206873', '48966383:6693286', '51385674:7163467'])

В качестве ID трека выступает его уникальный номер и номер альбома. Первым треком из примера является следующий трек: music.yandex.ru/album/1193829/track/10994777

Выполнение запросов с использование прокси:

from yandex_music.utils.request import Request
from yandex_music import Client

request = Request(proxy_url='socks5://user:password@host:port')
client = Client(request=request)

Примеры proxy url:

Больше примеров тут: proxies — advanced usage — requests

Пример инициализации клиента с обработкой капчи:

def init_client():
    client = captcha_key = captcha_answer = None
    while not client:
        try:
            client = Client.from_credentials('login', 'pass', captcha_answer, captcha_key)
        except Captcha as e:
            e.captcha.download('captcha.png')

            captcha_key = e.captcha.x_captcha_key
            captcha_answer = input('Число с картинки: ')

    return client

Пример инициализации клиента с обработкой капчи при помощи callback-функции:

def proc_captcha(captcha):
    captcha.download('captcha.png')
    return input('Число с картинки: ')

client = Client.from_credentials('login', 'pass', captcha_callback=proc_captcha)

Изучение по примерам

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

Код примеров опубликован в открытом доступе, поэтому Вы можете взять его и начать писать вокруг своё.

Посетите эту страницу чтобы изучить официальные примеры.

Логирование

Данная библиотека использует logging модуль. Чтобы настроить логирование на стандартный вывод, поместите

import logging
logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')

в начало вашего скрипта.

Вы также можете использовать логирование в вашем приложении, вызвав logging.getLogger() и установить уровень какой Вы хотите:

logger = logging.getLogger()
logger.setLevel(logging.INFO)

Если Вы хотите DEBUG логирование:

logger.setLevel(logging.DEBUG)

Дорабатываем Яндекс.Станцию для просмотра YouTube / Хабр

На Яндекс.Станции неудобно смотреть YouTube. Нет рекомендаций, подписок и даже поиск нормально не работает. Поэтому я написал телеграмм бота для отправки на неё любого видео.

Под катом история, как я это сделал несмотря на то, что официального открытого API нет.

С чего все началось?

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

{  
   "items":[  
      {  
         "icon":"https://avatars.mds.yandex.net/get-yandex-station/1540981/yandexstationicon/orig",
         "id":"************",
         "name":"Яндекс Станция",
         "online":true,
         "platform":"yandexstation",
         "screen_capable":true,
         "screen_present":true
      }
   ],
   "status":"ok"
}

{
  "status": "play",
  "msg": "success",
  "code": 1
}

def sendToScreen(video_url):

    # Auth and getting Session_id

    auth_data = {
            'login': config.login, 
            'passwd': config.password
            }

    s = requests.Session()
    s.get("https://passport.yandex.ru/")
    s.post("https://passport.yandex.ru/passport?mode=auth&retpath=https://yandex.ru", data=auth_data)
    
    Session_id = s.cookies["Session_id"]
    
    # Getting x-csrf-token
    token = s.get('https://frontend.vh.yandex.ru/csrf_token').text

    # Getting devices info TODO: device selection here
    devices_online_stats = s.get("https://quasar.yandex.ru/devices_online_stats").text
    devices = json.loads(devices_online_stats)["items"]

    # Preparing request
    headers = {
        "x-csrf-token": token,
    }

    data = {
        "msg": {
            "provider_item_id": video_url
        },
        "device": devices[0]["id"]
    }

    if "https://www.youtube" in video_url:
        data["msg"]["player_id"] = "youtube"

    # Sending command with video to device
    res = s.post("https://yandex.ru/video/station", data=json.dumps(data), headers=headers)

    return res.text