Spotify

Интеграция Spotify подключает Macro Deck к вашему аккаунту Spotify через Spotify Web API. Она управляет воспроизведением там, где Spotify играет для этого аккаунта: в приложении для компьютера, на телефоне, на колонке или на любом другом устройстве Spotify Connect. Spotify не обязательно должен быть запущен на том компьютере, где работает Macro Deck.

Для подключения создайте собственное небольшое приложение в Spotify Developer Dashboard и введите его Client ID и Client Secret в Macro Deck. Затем Macro Deck откроет вход в Spotify, и вы один раз разрешите доступ. Для управления воспроизведением через Web API нужен Spotify Premium: это правило Spotify, а не Macro Deck.

Что можно делать

• Воспроизводить, ставить на паузу, переключать треки, перематывать, включать и выключать перемешивание, выбирать режим повтора и менять громкость.
• Запускать определённый трек или плейлист. Если оставить выбор пустым, Macro Deck предложит выбрать при нажатии кнопки.
• Запускать воспроизведение на определённом устройстве или переносить его на другое устройство, продолжая воспроизведение или оставляя паузу.
• Добавлять текущий трек в «Любимые треки» или убирать его оттуда, а также добавлять его в плейлист или удалять из него.
• Показывать, что играет, в виджете Музыкальный проигрыватель с обложкой, прогрессом и кнопками воспроизведения и переключения.
• Использовать переменные, например spotify_current_track_name, в подписях кнопок и привязывать ползунок к spotify_volume или spotify_current_position.

Несколько примеров:

• Кнопка Toggle Play/Pause, которая показывает, играет музыка или стоит на паузе.
• Кнопка с сердечком и действием Переключить «Понравившийся трек», которая показывает, есть ли текущий трек в «Любимых треках».
• Кнопка, которая переносит воспроизведение с компьютера на колонку в гостиной с помощью действия Transfer Playback.
• Ползунок, привязанный к spotify_volume, который следует за громкостью и меняет её, пока вы его двигаете.

Как это работает

Macro Deck запрашивает у Spotify состояние воспроизведения примерно каждые 3 секунды, пока играет музыка, каждые 5 секунд на паузе и каждые 10 секунд, когда ничего не играет. Изменения, сделанные в приложении Spotify, появляются в течение этого времени. Токены доступа обновляются в фоне, поэтому входить снова нужно, только если Spotify отзовёт доступ. Если Spotify ограничивает число запросов или не отвечает, Macro Deck делает паузу, сохраняет последнее известное состояние и показывает проблему на странице Spotify в разделе Интеграции, пока не сможет продолжить. Подключить можно один аккаунт Spotify.