Music DJ: Spotify, YouTube и локальная музыка

Music DJ включает фоновую музыку под вашу сцену. В этом руководстве показано, как подключить Spotify, YouTube или собственные аудиофайлы, как пользоваться музыкальным плеером и как включать музыку в Game Mode и Conversation.

Что такое Music DJ

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

Перед началом: откройте Agents (агенты), выберите Agent Organizer (организатор агентов) и установите Music DJ. После установки он выключен. Для чата он включается так же, как любой другой агент. Он работает в чатах Roleplay, в Game Mode – через отдельный переключатель (Music DJ в режиме Game Mode), а в Conversation – через команду Music (Команда Music в режиме Conversation).

Он играет музыку из трех источников.

ИсточникНужен аккаунтСтоимостьДля чего лучше
SpotifyСобственный аккаунт Spotify, а для воспроизведения – Spotify PremiumНастройка бесплатна, для воспроизведения нужен PremiumНастоящие песни с названиями на ваших собственных устройствах
YouTubeБесплатный ключ API GoogleБесплатноВоспроизведение без входа в аккаунт и без Premium
CustomНе нуженБесплатноВаши собственные аудиофайлы

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

Music DJ настраивается в одном общем месте. Откройте правую панель Agents, затем Music DJ. Можно также нажать иконку шестеренки на мини-плеере (всплывающая подсказка Music DJ setup).

Выбор источника музыки

В редакторе Music DJ у поля Music Player есть три кнопки: Spotify, YouTube и Custom. Строка под ними показывает, что активно сейчас, например "Visible player: Spotify. Saved provider: Spotify." Этот выбор общий для всего приложения и не сохраняется отдельно для каждого чата.

Настройка Spotify

Spotify работает через ваше собственное бесплатное приложение разработчика Spotify. Вставить нужно только Spotify Client ID. Клиентского секрета нет.

  1. В редакторе Music DJ найдите Spotify Connection.
  2. Откройте Spotify Developer Dashboard по ссылке, которая показана в приложении.
  3. Создайте новое приложение и выберите "Web API".
  4. В Redirect URIs этого приложения добавьте ровно тот адрес перенаправления, который Marinara показывает в шаге 3 встроенной инструкции. Адрес перенаправления – это адрес, на который Spotify возвращает вас после входа.
  5. Скопируйте Client ID и вставьте его в Spotify Client ID.
  6. Сохраните агента, затем нажмите Connect Spotify Account.

Откроется окно входа Spotify с запросом разрешений. После подтверждения оно покажет короткую страницу об успешном подключении и закроется. Marinara покажет зеленую плашку Connected to Spotify. Disconnect удаляет сохраненное подключение.

Примечание: для воспроизведения, паузы, переключения треков и громкости нужна подписка Spotify Premium (платный тариф). Бесплатный аккаунт подключить можно. Токены обновляются автоматически.

Если не получилось: на другой машине окно входа может не сработать (см. ниже). В остальных случаях проверьте, что адрес перенаправления совпадает в точности.

Устройства Spotify

Spotify играет через устройство: ваш телефон, приложение Spotify на компьютере или встроенный плеер.

Spotify на другой машине

Spotify принимает только защищенные адреса перенаправления https:// или адрес обратной петли http://127.0.0.1 (тот же компьютер). Если Marinara работает на другой машине по обычному http, окно входа может не сработать. Есть два решения:

SPOTIFY_REDIRECT_URI=https://your-address/api/spotify/callback

См. Настройки сервера: справочник.

Откуда Spotify берет песни (Roleplay)

Когда Music DJ работает в чате Roleplay, в его карточке есть список Spotify source.

Настройка YouTube

Режиму YouTube нужен бесплатный ключ YouTube Data API. Ключ API – это секретный код, который позволяет Marinara пользоваться сервисом от вашего имени. Вход в YouTube и подписка Premium не нужны.

  1. В редакторе Music DJ найдите YouTube Connection.
  2. Откройте Google Cloud Console по ссылке в приложении и создайте проект или выберите готовый.
  3. Включите YouTube Data API v3.
  4. Перейдите в Credentials, затем Create credentials, затем API key.
  5. Вставьте ключ в YouTube Data API Key.
  6. Нажмите Save Key. После этого надпись на кнопке сменится на Update Key и появится зеленая плашка "API key configured". Remove удаляет ключ.

Оставьте ключ без ограничений или ограничьте его только по API, выбрав YouTube Data API v3. Не ограничивайте его по HTTP-referrer. Поиск идет с сервера, поэтому такое ограничение его заблокирует. Приложение сообщает, что бесплатной квоты (около 100 поисков в день) для личного DJ более чем достаточно. Эта цифра взята из текста приложения и может измениться. Ключ остается на сервере в зашифрованном виде.

Собственные музыкальные файлы

Режим Custom проигрывает аудиофайлы с машины, на которой работает Marinara. Поддерживаются типы .mp3, .ogg, .wav, .flac, .m4a, .aac и .webm.

В редакторе Music DJ найдите Custom Music Library. В нем один переключатель: Use Game Assets music folder.

Настройка Roleplay и Game показывает тот же источник. Если вы выбрали папку на устройстве сервера, настройки Music DJ в чате показывают этот путь и кнопку Choose Folder (выбрать папку).

Для воспроизведения из папки за пределами Game Assets нужен локальный доступ на сервере. С другого устройства без входа или секрета администратора эта возможность может быть заблокирована. См. Удаленный доступ: вход и список разрешенных адресов.

Работа с музыкальным плеером

Music Player – это плашка в верхней строке на компьютере и перетаскиваемый виджет на телефоне. Чтобы показать или скрыть его, откройте Settings → General → App Behavior (настройки → общие → поведение приложения) и переключите Music Player. По умолчанию он включен. Если он включен, а Music DJ не установлен, плеер показывает Download Music DJ Agent to configure и кнопку Agent Organizer.

В новом профиле источником сначала стоит YouTube. Сменить его можно круглым переключателем источника на плеере (всплывающая подсказка "Switch to ... player"), кнопками Music Player в редакторе или настройками Music DJ в чате.

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

DJ Mari: сборка плейлистов силами ИИ

Кнопка DJ на мини-плеере Spotify ("DJ Mari composes a playlist for you!") собирает тематический плейлист. DJ Mari просит подключенную модель ИИ составить его по вашей персоне, самому частому персонажу и недавним чатам во всех разговорах. Подобранные песни добавляются в новый плейлист Spotify с названием "DJ Mari" и сегодняшней датой, и он начинает играть.

Ему нужны две вещи.

При успехе появляется сообщение "DJ Mari playlist is ready" с кнопкой Open playlist.

Music DJ в режиме Game Mode

У Game Mode есть своя фоновая музыка из Game Assets. Чтобы вместо нее играл Music DJ, включите переключатель Music DJ в настройке игры ("Use the Music DJ for this game instead of local music assets"). По умолчанию он выключен. После этого доступны те же варианты Spotify, YouTube и Custom и те же поля, что и в Roleplay.

Со Spotify после каждой сцены сервер собирает короткий список реально существующих песен-кандидатов из выбранного источника, и ИИ выбирает одну из них. Так ИИ не выдумывает песню. Game Mode проигрывает по одной песне за раз по кругу. Чтобы заново подобрать музыку для текущей сцены, откройте Game controls (управление игрой) и выберите Retry Music DJ. См. Элементы управления игрой.

Команда Music в режиме Conversation

В Conversation добавить Music DJ как агента нельзя. Вместо этого персонажи включают песни командой Music.

  1. Откройте раздел Commands в чате и включите главный переключатель Commands (команды).
  2. Включите Music ("Let characters play songs through the active Music Player").

После этого персонаж может назвать песню для Spotify или описать трек для YouTube, и Marinara проигрывает его через активный источник. Это работает, даже если Music DJ нигде не включен. Нужен только подключенный Spotify или сохраненный ключ YouTube. Если Spotify не подключен или у него нет разрешения на воспроизведение, команда с песней Spotify ничего не делает и не показывает ошибку.

Устранение неполадок

Смежные руководства