Spotify
Входить до Macro DeckКеруйте відтворенням Spotify, додавайте пісні до улюблених, керуйте плейлистами й показуйте, що грає, на своїй панелі.
Два віджети «Музичний програвач», що відтворюють трек, один у стилі «Повна обкладинка», другий у стилі «Мала обкладинка», обидва з назвою та логотипом Spotify у заголовку
- Відтворення, пауза, перемикання, перемотування, перемішування, повтор і гучність
- Відтворюйте трек чи плейлист або вибирайте його під час натискання кнопки
- Додавайте пісні до улюблених і поточний трек до плейлиста
- Переносьте відтворення на інший пристрій 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.
Що потрібно
- Обліковий запис Spotify Premium. Spotify дозволяє керувати відтворенням через Web API лише обліковим записам Premium.
- Власний застосунок у Spotify Developer Dashboard для отримання Client ID і Client Secret.
- Веббраузер на комп’ютері, де працює Macro Deck, для входу в Spotify.
- Spotify, відкритий щонайменше на одному пристрої, щоб було чим керувати.
Як налаштувати
Крок 1: Створіть застосунок у Spotify Developer Dashboard
Відкрийте Spotify Developer Dashboard на developer.spotify.com/dashboard, увійдіть і створіть новий застосунок. Підійдуть будь-які назва й опис.
Крок 2: Почніть налаштування в Macro Deck
У Macro Deck натисніть Інтеграції на бічній панелі, а потім Spotify. На вкладці Огляд натисніть Налаштувати в розділі Конфігурація. Перемикач угорі праворуч відкриває той самий діалог, а інтеграцію буде ввімкнено, щойно налаштування завершиться. Діалог Підключити Spotify показує Redirect URI з кнопкою копіювання.
Крок 3: Додайте Redirect URI до свого застосунку Spotify
У параметрах свого застосунку Spotify додайте Redirect URI, який показує Macro Deck, точно в такому вигляді, і збережіть.
Крок 4: Введіть Client ID і Client Secret
Скопіюйте Client ID і Client Secret зі свого застосунку Spotify і вставте їх в однойменні поля в Macro Deck. Потім натисніть Продовжити.
Крок 5: Дозвольте доступ у браузері
Macro Deck відкриє вхід у Spotify у вашому браузері, а діалог покаже Очікування авторизації…. Увійдіть з обліковим записом Premium і дозвольте доступ, потім поверніться до Macro Deck. Налаштування продовжиться саме й отримає назву за вашим обліковим записом Spotify, наприклад Spotify (Alex). Коли діалог покаже Налаштування завершено., натисніть Готово.
Крок 6: Додайте дію на кнопку
На сторінці Панель клацніть кнопку, яку хочете використати. Панель має бути розблокована: якщо кнопка вгорі праворуч показує Заблокувати, панель розблоковано. Відкриється редактор, у якому вибрано Коротке натискання. Натисніть + Додати дію, ліворуч у діалозі Додати дію виберіть Spotify і виберіть дію, наприклад Toggle Play/Pause. Потім натисніть Зберегти.
Крок 7: Натисніть кнопку
Увімкніть щось у Spotify на будь-якому пристрої, потім натисніть кнопку на своїй панелі. Відтворення стане на паузу або продовжиться.
Дії18
Призначте їх кнопці або запускайте з потоку.
- Play
- Продовжує відтворення.
- Pause
- Ставить відтворення на паузу.
- Toggle Play/Pause
- Перемикає між відтворенням і паузою та показує стан відтворення на кнопці.
- Next Track
- Переходить до наступного треку.
- Previous Track
- Переходить до попереднього треку.
- Refresh State
- Одразу запитує в Spotify поточний стан відтворення.
- Set Volume
- Задає гучність пристрою, що відтворює, від 0 до 100%.
- Volume Up
- Збільшує гучність на 10%.
- Volume Down
- Зменшує гучність на 10%.
- Seek
- Переходить до позиції в поточному треку, у секундах.
- Toggle Shuffle
- Вмикає, вимикає або перемикає перемішування та показує, чи воно ввімкнене.
- Set Repeat Mode
- Встановлює повтор у режим Off, Repeat Track або Repeat Album/Playlist.
- Play Track
- Відтворює трек, який ви шукаєте або вибираєте з улюблених пісень, або просить вибрати його під час виконання дії.
- Play Playlist
- Відтворює один із ваших плейлистів або знайдений плейлист, або просить вибрати його під час виконання дії.
- Play on Device
- Запускає відтворення на певному пристрої Spotify або просить вибрати його під час виконання дії.
- Transfer Playback
- Переносить відтворення на інший пристрій, продовжуючи його чи залишаючи на паузі.
- Перемкнути улюблену пісню
- Додає поточний трек чи епізод до улюблених пісень або вилучає з них і показує, чи він серед улюблених.
- Додати або вилучити з плейліста
- Додає поточний трек чи епізод до плейлиста або вилучає з нього й показує, чи він є в цьому плейлисті.
Тригери8
Кнопка або потік можуть реагувати на ці події.
- Трек змінено
- Почав відтворюватися інший трек, з назвою, виконавцем і альбомом (у групі Музичний програвач).
- Відтворення розпочато
- Відтворення почалося або продовжилося (у групі Музичний програвач).
- Відтворення призупинено
- Відтворення поставлено на паузу (у групі Музичний програвач).
- Відтворення зупинено
- Відтворення зупинилося (у групі Музичний програвач).
- Змінено пристрій відтворення
- Відтворення перейшло на інший пристрій (у групі Музичний програвач).
- Гучність змінено
- Гучність змінилася, з новим і попереднім значенням (у групі Музичний програвач).
- Програвач під’єднано
- Spotify став доступним (у групі Музичний програвач).
- Програвача від’єднано
- Spotify більше не доступний (у групі Музичний програвач).
Змінні19
Показуйте ці значення на кнопках і віджетах або використовуйте їх в умовах.
spotify_current_track_name- Назва треку, що відтворюється.
spotify_current_artist- Виконавці поточного треку через кому.
spotify_current_album- Альбом поточного треку.
spotify_playback_state- Стан відтворення:
playing,pausedабоstopped. spotify_is_playing- Чи грає музика саме зараз.
spotify_volume- Гучність у відсотках. Її також можна задавати, наприклад повзунком.
spotify_track_duration- Тривалість поточного треку в секундах.
spotify_current_position- Скільки секунд треку вже відтворено. Задавши це значення, можна перемотати.
spotify_progress_percentage- Яку частину треку вже відтворено, у відсотках.
spotify_album_art_url- Адреса поточної обкладинки в Macro Deck.
spotify_device_name- Назва пристрою, що відтворює.
spotify_device_type- Тип пристрою, що відтворює, наприклад комп’ютер або колонка.
spotify_shuffle_enabled- Чи ввімкнено перемішування.
spotify_repeat_mode- Режим повтору:
off,trackабоcontext. spotify_is_connected- Чи може Macro Deck під’єднатися до Spotify і чи є придатний сеанс.
spotify_current_track_url- Посилання Spotify на поточний трек.
spotify_current_track_is_liked- Чи є поточний трек серед улюблених пісень.
spotify_top_track,spotify_top_artist- Ваш найчастіше прослуханий трек і виконавець.
spotify_top_tracks,spotify_top_artists- Ваші найчастіше прослухані треки й виконавці у вигляді списку.
Віджети1
Додайте їх на свою панель через вибір віджетів.
- Музичний програвач
- Показує трек, виконавців і обкладинку, які відтворює Spotify, з прогресом і кнопками відтворення, паузи й перемикання.
Поширені запитання
Навіщо потрібен Spotify Premium?
Spotify дозволяє керувати відтворенням через Web API лише обліковим записам Premium. З безкоштовним обліковим записом Spotify відхиляє команди, а Macro Deck показує проблему Потрібен Spotify Premium на сторінці Spotify у розділі Інтеграції. Це обмеження Spotify, а не Macro Deck.
Навіщо створювати власний застосунок Spotify?
Macro Deck звертається до Spotify з Client ID і Client Secret застосунку, яким володієте ви. Spotify рахує запити для кожного застосунку окремо, тож ваша панель не ділить свій ліміт з іншими користувачами. Створення застосунку безкоштовне й займає хвилину в Spotify Developer Dashboard.
Чи має Spotify працювати на тому самому комп’ютері, що й Macro Deck?
Ні. Macro Deck керує вашим обліковим записом через інтернет, тож керує Spotify на будь-якому пристрої, що відтворює для цього облікового запису, як-от на телефоні чи колонці Spotify Connect. Пристрій вибирається в діях Play on Device і Transfer Playback.
Чи можна під’єднати кілька облікових записів Spotify?
Ні. Інтеграція підтримує одне налаштування. Кнопка Налаштувати знову замінює його іншим обліковим записом, а ваші кнопки й віджети продовжують працювати.
Macro Deck повідомляє, що Spotify обмежує запити. Що робити?
Spotify перестає відповідати, коли з обліковими даними вашого застосунку надходить забагато запитів. Macro Deck призупиняє свої запити й повідомляє, коли продовжить. Ліміт враховує всі застосунки з тим самим Client ID, тож зазвичай допомагає закрити інші застосунки, які його використовують.
Де зберігаються мої облікові дані Spotify?
Client Secret і токени, які видає Spotify, зберігаються в зашифрованому вигляді на комп’ютері, де працює Macro Deck. Вони надсилаються лише в Spotify. Пароль Spotify ніколи не вводиться в Macro Deck; ви входите на сайті Spotify.
Більше в категорії «Музика та звук»
YouTube Music Desktop App
Входить до Macro DeckКеруйте YouTube Music Desktop App зі своєї панелі: відтворення, гучність, оцінки й те, що грає.
WebNowPlaying
Входить до Macro DeckКеруйте музикою й відео в браузері та показуйте, що грає, через розширення WebNowPlaying.
Jellyfin
Входить до Macro DeckКеруйте застосунками й телевізорами Jellyfin зі своєї панелі, показуйте, що відтворюється, і реагуйте на початок чи зупинку відтворення.
SoundPad
Входить до Macro DeckВідтворюйте звуки зі списку SoundPad, керуйте записами й показуйте поточний звук на панелі.
Voicemeeter
Входить до Macro DeckКеруйте підсиленням, вимкненням звуку, маршрутизацією й макрокнопками Voicemeeter, Banana або Potato зі своєї панелі.