Spotify
Dołączona do Macro DeckSteruj odtwarzaniem Spotify, oznaczaj utwory jako polubione, zarządzaj playlistami i pokazuj na decku, co jest odtwarzane.
Dwa widżety Odtwarzacz muzyki odtwarzające utwór, jeden w stylu Pełna okładka, drugi w stylu Mała okładka, oba z nazwą i logo Spotify w nagłówku
- Odtwarzanie, wstrzymanie, przełączanie, przewijanie, odtwarzanie losowe, powtarzanie i głośność
- Odtwarzanie utworu lub playlisty albo wybór przy naciśnięciu przycisku
- Polubienie utworów i dodawanie bieżącego utworu do playlisty
- Przenoszenie odtwarzania na inne urządzenie Spotify
- Widżet Odtwarzacz muzyki i zmienne dla utworu, wykonawcy i postępu
Integracja Spotify łączy Macro Deck z kontem Spotify przez Spotify Web API. Steruje odtwarzaniem wszędzie tam, gdzie Spotify odtwarza dla tego konta: w aplikacji na komputer, na telefonie, na głośniku lub na dowolnym innym urządzeniu Spotify Connect. Spotify nie musi działać na komputerze, na którym działa Macro Deck.
Aby się połączyć, należy utworzyć własną małą aplikację w Spotify Developer Dashboard i wpisać jej Identyfikator klienta i Tajny klucz klienta w Macro Deck. Macro Deck otworzy wtedy logowanie do Spotify, w którym jednorazowo zezwala się na dostęp. Sterowanie odtwarzaniem przez Web API wymaga Spotify Premium; to zasada Spotify, a nie Macro Deck.
Możliwości
- Odtwarzanie, wstrzymywanie, przełączanie utworów, przewijanie, włączanie i wyłączanie odtwarzania losowego, ustawianie trybu powtarzania i zmiana głośności.
- Uruchamianie konkretnego utworu lub playlisty. Jeśli wybór pozostanie pusty, Macro Deck poprosi o wskazanie pozycji przy naciśnięciu przycisku.
- Rozpoczynanie odtwarzania na konkretnym urządzeniu albo przenoszenie odtwarzania na inne urządzenie z zachowaniem odtwarzania lub wstrzymania.
- Dodawanie bieżącego utworu do Polubionych utworów lub usuwanie go z nich oraz dodawanie go do playlisty lub usuwanie z niej.
- Wyświetlanie bieżącego odtwarzania w widżecie Odtwarzacz muzyki z okładką, postępem oraz przyciskami odtwarzania i przełączania.
- Używanie zmiennych takich jak
spotify_current_track_namew etykietach przycisków oraz powiązanie suwaka ze zmiennąspotify_volumelubspotify_current_position.
Przykładowe zastosowania:
- Przycisk Toggle Play/Pause, który pokazuje, czy muzyka jest odtwarzana, czy wstrzymana.
- Przycisk z sercem i akcją Przełącz status ulubionego utworu, który pokazuje, czy bieżący utwór jest w Polubionych utworach.
- Przycisk, który akcją Transfer Playback przenosi odtwarzanie z komputera na głośnik w salonie.
- Suwak powiązany z
spotify_volume, który nadąża za głośnością i zmienia ją podczas przeciągania.
Działanie
Macro Deck pyta Spotify o stan odtwarzania mniej więcej co 3 sekundy podczas odtwarzania, co 5 sekund po wstrzymaniu i co 10 sekund, gdy nic nie jest odtwarzane. Zmiany wprowadzone w aplikacji Spotify pojawiają się w tym czasie. Tokeny dostępu są odnawiane w tle, więc ponowne logowanie jest potrzebne tylko wtedy, gdy Spotify cofnie dostęp. Gdy Spotify ogranicza liczbę żądań lub nie odpowiada, Macro Deck robi przerwę, zachowuje ostatni znany stan i pokazuje problem na stronie Spotify w sekcji Integracje, dopóki nie może kontynuować. Można połączyć jedno konto Spotify.
Czego potrzebujesz
- Konto Spotify Premium. Spotify pozwala sterować odtwarzaniem przez Web API tylko kontom Premium.
- Własna aplikacja w Spotify Developer Dashboard, z której pochodzą Client ID i Client Secret.
- Przeglądarka na komputerze, na którym działa Macro Deck, do logowania do Spotify.
- Spotify otwarte na co najmniej jednym urządzeniu, aby było czym sterować.
Konfiguracja krok po kroku
Krok 1: Utwórz aplikację w Spotify Developer Dashboard
Otwórz Spotify Developer Dashboard pod adresem developer.spotify.com/dashboard, zaloguj się i utwórz nową aplikację. Nazwa i opis mogą być dowolne.
Krok 2: Rozpocznij konfigurację w Macro Deck
W Macro Deck kliknij Integracje na pasku bocznym, a następnie Spotify. Na karcie Przegląd kliknij Skonfiguruj w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno, a integracja zostaje włączona po zakończeniu konfiguracji. Okno Połącz Spotify pokazuje URI przekierowania z przyciskiem kopiowania.
Krok 3: Dodaj URI przekierowania do aplikacji Spotify
W ustawieniach aplikacji Spotify dodaj URI przekierowania pokazany przez Macro Deck, dokładnie w tej postaci, i zapisz.
Krok 4: Wprowadź identyfikator i tajny klucz klienta
Skopiuj Client ID i Client Secret z aplikacji Spotify i wklej je w polach Identyfikator klienta i Tajny klucz klienta w Macro Deck. Następnie kliknij Dalej.
Krok 5: Zezwól na dostęp w przeglądarce
Macro Deck otworzy logowanie do Spotify w przeglądarce, a okno pokaże Oczekiwanie na autoryzację…. Zaloguj się kontem Premium i zezwól na dostęp, a następnie wróć do Macro Deck. Konfiguracja przejdzie dalej samodzielnie i otrzyma nazwę według konta Spotify, np. Spotify (Alex). Gdy okno pokaże Konfiguracja zakończona., kliknij Gotowe.
Krok 6: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk, który ma zostać użyty. Deck musi być odblokowany: jest odblokowany, gdy przycisk w prawym górnym rogu ma etykietę Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Spotify i wybierz akcję, np. Toggle Play/Pause. Następnie kliknij Zapisz.
Krok 7: Naciśnij przycisk
Uruchom odtwarzanie w Spotify na dowolnym urządzeniu, a następnie naciśnij przycisk na decku. Odtwarzanie zostanie wstrzymane lub wznowione.
Akcje18
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Play
- Wznawia odtwarzanie.
- Pause
- Wstrzymuje odtwarzanie.
- Toggle Play/Pause
- Przełącza między odtwarzaniem a wstrzymaniem i pokazuje stan odtwarzania na przycisku.
- Next Track
- Przechodzi do następnego utworu.
- Previous Track
- Przechodzi do poprzedniego utworu.
- Refresh State
- Od razu pyta Spotify o bieżący stan odtwarzania.
- Set Volume
- Ustawia głośność odtwarzającego urządzenia w zakresie od 0 do 100%.
- Volume Up
- Zwiększa głośność o 10%.
- Volume Down
- Zmniejsza głośność o 10%.
- Seek
- Przeskakuje do wybranego miejsca bieżącego utworu, w sekundach.
- Toggle Shuffle
- Włącza, wyłącza lub przełącza odtwarzanie losowe i pokazuje, czy jest włączone.
- Set Repeat Mode
- Ustawia powtarzanie na Off, Repeat Track lub Repeat Album/Playlist.
- Play Track
- Odtwarza wyszukany utwór lub utwór wybrany z Polubionych utworów albo prosi o wybór przy uruchomieniu akcji.
- Play Playlist
- Odtwarza jedną z własnych playlist lub wyszukaną playlistę albo prosi o wybór przy uruchomieniu akcji.
- Play on Device
- Rozpoczyna odtwarzanie na konkretnym urządzeniu Spotify albo prosi o wybór przy uruchomieniu akcji.
- Transfer Playback
- Przenosi odtwarzanie na inne urządzenie z zachowaniem odtwarzania lub wstrzymania.
- Przełącz status ulubionego utworu
- Dodaje bieżący utwór lub odcinek do Polubionych utworów albo go z nich usuwa i pokazuje, czy jest polubiony.
- Dodaj lub usuń z playlisty
- Dodaje bieżący utwór lub odcinek do playlisty albo go z niej usuwa i pokazuje, czy jest na tej playliście.
Wyzwalacze8
Przycisk lub przebieg może reagować na te zdarzenia.
- Utwór zmieniony
- Zaczął być odtwarzany inny utwór, wraz z tytułem, wykonawcą i albumem (w grupie Music Player).
- Odtwarzanie rozpoczęte
- Odtwarzanie rozpoczęło się lub zostało wznowione (w grupie Music Player).
- Odtwarzanie wstrzymane
- Odtwarzanie zostało wstrzymane (w grupie Music Player).
- Odtwarzanie zatrzymane
- Odtwarzanie zostało zatrzymane (w grupie Music Player).
- Urządzenie odtwarzające zmienione
- Odtwarzanie przeniosło się na inne urządzenie (w grupie Music Player).
- Głośność zmieniona
- Głośność się zmieniła, wraz z nową i poprzednią wartością (w grupie Music Player).
- Odtwarzacz połączony
- Spotify stało się osiągalne (w grupie Music Player).
- Odtwarzacz rozłączony
- Spotify nie jest już osiągalne (w grupie Music Player).
Zmienne19
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
spotify_current_track_name- Tytuł odtwarzanego utworu.
spotify_current_artist- Wykonawcy bieżącego utworu rozdzieleni przecinkami.
spotify_current_album- Album bieżącego utworu.
spotify_playback_state- Stan odtwarzania:
playing,pausedlubstopped. spotify_is_playing- Czy muzyka jest teraz odtwarzana.
spotify_volume- Głośność w procentach. Można ją też ustawiać, np. suwakiem.
spotify_track_duration- Długość bieżącego utworu w sekundach.
spotify_current_position- Czas odtworzenia utworu w sekundach. Ustawienie tej wartości przewija utwór.
spotify_progress_percentage- Postęp odtwarzania utworu w procentach.
spotify_album_art_url- Adres bieżącej okładki w Macro Deck.
spotify_device_name- Nazwa odtwarzającego urządzenia.
spotify_device_type- Typ odtwarzającego urządzenia, np. komputer lub głośnik.
spotify_shuffle_enabled- Czy odtwarzanie losowe jest włączone.
spotify_repeat_mode- Tryb powtarzania:
off,tracklubcontext. spotify_is_connected- Czy Macro Deck łączy się ze Spotify i istnieje sesja, z której można korzystać.
spotify_current_track_url- Link Spotify do bieżącego utworu.
spotify_current_track_is_liked- Czy bieżący utwór jest w Polubionych utworach.
spotify_top_track,spotify_top_artist- Najczęściej odtwarzany utwór i wykonawca.
spotify_top_tracks,spotify_top_artists- Najczęściej odtwarzane utwory i wykonawcy w postaci listy.
Widżety1
Dodaj je do decku z selektora widżetów.
- Odtwarzacz muzyki
- Pokazuje utwór, wykonawców i okładkę odtwarzane przez Spotify, z postępem oraz przyciskami odtwarzania, wstrzymania i przełączania.
Najczęściej zadawane pytania
Dlaczego potrzebuję Spotify Premium?
Spotify pozwala sterować odtwarzaniem przez Web API tylko kontom Premium. Przy darmowym koncie Spotify odrzuca polecenia, a Macro Deck pokazuje problem Wymagane Spotify Premium na stronie Spotify w sekcji Integracje. To ograniczenie Spotify, a nie Macro Deck.
Dlaczego muszę utworzyć własną aplikację Spotify?
Macro Deck komunikuje się ze Spotify za pomocą Client ID i Client Secret własnej aplikacji. Spotify liczy żądania osobno dla każdej aplikacji, więc deck nie dzieli swojego limitu z innymi użytkownikami. Utworzenie aplikacji w Spotify Developer Dashboard jest bezpłatne i zajmuje minutę.
Czy Spotify musi działać na tym samym komputerze co Macro Deck?
Nie. Macro Deck steruje kontem przez internet, więc steruje Spotify na każdym urządzeniu, które odtwarza dla tego konta, np. na telefonie lub głośniku Spotify Connect. Urządzenie wybiera się akcjami Play on Device i Transfer Playback.
Czy mogę połączyć więcej niż jedno konto Spotify?
Nie. Integracja obsługuje jedną konfigurację. Skonfiguruj ponownie zastępuje ją innym kontem, a przyciski i widżety działają dalej.
Macro Deck informuje, że Spotify ogranicza liczbę żądań. Co zrobić?
Spotify przestaje odpowiadać, gdy z danymi uwierzytelniającymi aplikacji wysłano zbyt wiele żądań. Macro Deck wstrzymuje żądania i informuje, kiedy wznowi działanie. Limit obejmuje każdą aplikację korzystającą z tego samego Client ID, więc zwykle pomaga zamknięcie innych aplikacji, które go używają.
Gdzie są przechowywane moje dane uwierzytelniające Spotify?
Tajny klucz klienta i tokeny wydawane przez Spotify są przechowywane w postaci zaszyfrowanej na komputerze, na którym działa Macro Deck. Są wysyłane wyłącznie do Spotify. Hasła do Spotify nigdy nie wpisuje się w Macro Deck; logowanie odbywa się na stronie Spotify.
Więcej w kategorii Muzyka i dźwięk
YouTube Music Desktop App
Dołączona do Macro DeckSteruj YouTube Music Desktop App z decku: odtwarzanie, głośność, oceny i bieżący utwór.
WebNowPlaying
Dołączona do Macro DeckSteruj muzyką i filmami odtwarzanymi w przeglądarce i pokazuj, co jest odtwarzane, za pomocą rozszerzenia WebNowPlaying.
Jellyfin
Dołączona do Macro DeckSteruj aplikacjami Jellyfin i telewizorami z decku, pokazuj, co jest odtwarzane, i reaguj na rozpoczęcie lub zatrzymanie odtwarzania.
SoundPad
Dołączona do Macro DeckOdtwarzaj dźwięki z listy SoundPad, steruj nagraniami i pokazuj na decku odtwarzany dźwięk.
Voicemeeter
Dołączona do Macro DeckSteruj wzmocnieniem, wyciszeniem, routingiem i przyciskami makr Voicemeeter, Banana lub Potato z decku.