Spotify
Součást Macro DeckOvládejte přehrávání Spotify, označujte skladby jako oblíbené, spravujte playlisty a zobrazujte na decku, co hraje.
Dva widgety Přehrávač hudby přehrávající skladbu, jeden ve stylu Celý obal a jeden ve stylu Malý obal, oba s názvem a logem Spotify v záhlaví
- Přehrávání, pauza, přeskakování, přetáčení, náhodné přehrávání, opakování a hlasitost
- Přehrání skladby nebo playlistu, nebo výběr při stisknutí tlačítka
- Označení skladeb jako oblíbených a přidání aktuální skladby do playlistu
- Přesun přehrávání na jiné zařízení Spotify
- Widget Přehrávač hudby a proměnné pro skladbu, interpreta a průběh
Integrace Spotify propojuje Macro Deck s vaším účtem Spotify přes Spotify Web API. Ovládá přehrávání všude, kde pro tento účet Spotify hraje: v desktopové aplikaci, v telefonu, na reproduktoru nebo na jakémkoli jiném zařízení Spotify Connect. Spotify nemusí běžet na počítači, na kterém běží Macro Deck.
Pro připojení vytvoříte v Spotify Developer Dashboard malou vlastní aplikaci a její Client ID a Client Secret zadáte v Macro Deck. Macro Deck pak otevře přihlášení ke Spotify a vy jednou povolíte přístup. Ovládání přehrávání přes Web API vyžaduje Spotify Premium; je to pravidlo Spotify, ne Macro Deck.
Co můžete dělat
- Přehrát, pozastavit, přeskočit, přetočit, zapnout nebo vypnout náhodné přehrávání, nastavit režim opakování a změnit hlasitost.
- Spustit konkrétní skladbu nebo playlist. Když výběr necháte prázdný, Macro Deck vás při stisknutí tlačítka požádá o výběr.
- Spustit přehrávání na konkrétním zařízení, nebo přehrávání přesunout na jiné zařízení a nechat ho hrát či pozastavené.
- Přidat aktuální skladbu do Oblíbených skladeb nebo ji z nich odebrat a přidat ji do playlistu nebo ji z něj odebrat.
- Zobrazit, co hraje, ve widgetu Přehrávač hudby s obalem, průběhem a tlačítky pro přehrání a přeskočení.
- Používat proměnné jako
spotify_current_track_namev popiscích tlačítek a propojit posuvník sspotify_volumenebospotify_current_position.
Několik příkladů použití:
- Tlačítko Toggle Play/Pause, které ukazuje, zda hudba hraje, nebo je pozastavená.
- Tlačítko se srdcem s akcí Přepnout oblíbenou skladbu, které ukazuje, zda je aktuální skladba v Oblíbených skladbách.
- Tlačítko, které pomocí Transfer Playback přesune přehrávání z počítače na reproduktor v obýváku.
- Posuvník propojený s
spotify_volume, který sleduje hlasitost a při tažení ji mění.
Jak se chová
Macro Deck se Spotify ptá na stav přehrávání přibližně každé 3 sekundy, když hraje hudba, každých 5 sekund, když je pozastavená, a každých 10 sekund, když nic nehraje. Změny, které uděláte v aplikaci Spotify, se projeví během této doby. Přístupové tokeny se obnovují na pozadí, takže se znovu přihlašujete, jen když Spotify přístup odvolá. Když Spotify omezí počet požadavků nebo neodpovídá, Macro Deck se pozastaví, ponechá si poslední známý stav a zobrazí problém na stránce Spotify v části Integrace, dokud nemůže pokračovat. Připojit lze jeden účet Spotify.
Co budete potřebovat
- Účet Spotify Premium. Spotify povoluje ovládání přehrávání přes Web API jen účtům Premium.
- Vlastní aplikace v Spotify Developer Dashboard kvůli jejímu Client ID a Client Secret.
- Webový prohlížeč na počítači, na kterém běží Macro Deck, pro přihlášení ke Spotify.
- Spotify otevřené alespoň na jednom zařízení, aby bylo co ovládat.
Nastavení
Krok 1: Vytvořte aplikaci v Spotify Developer Dashboard
Otevřete Spotify Developer Dashboard na developer.spotify.com/dashboard, přihlaste se a vytvořte novou aplikaci. Název a popis mohou být libovolné.
Krok 2: Spusťte nastavení v Macro Deck
V Macro Deck klikněte na postranním panelu na Integrace a pak na Spotify. Na kartě Přehled klikněte v části Konfigurace na Nastavit. Stejný dialog otevře i přepínač vpravo nahoře; po dokončení nastavení se integrace zapne. Dialog Připojit Spotify zobrazí Redirect URI s tlačítkem pro kopírování.
Krok 3: Přidejte Redirect URI do své aplikace Spotify
V nastavení své aplikace Spotify přidejte Redirect URI, které Macro Deck zobrazuje, přesně tak, jak je uvedené, a uložte.
Krok 4: Zadejte Client ID a Client Secret
Zkopírujte Client ID a Client Secret ze své aplikace Spotify a vložte je do stejnojmenných polí v Macro Deck. Pak klikněte na Pokračovat.
Krok 5: Povolte přístup v prohlížeči
Macro Deck otevře v prohlížeči přihlášení ke Spotify a dialog zobrazí Čekání na autorizaci…. Přihlaste se účtem Premium a povolte přístup, pak se vraťte do Macro Deck. Nastavení pokračuje samo a pojmenuje konfiguraci podle vašeho účtu Spotify, například Spotify (Alex). Když dialog zobrazí Nastavení dokončeno., klikněte na Hotovo.
Krok 6: Přidejte akci na tlačítko
Na stránce Deck klikněte na tlačítko, které chcete použít. Deck musí být odemčený: pokud tlačítko vpravo nahoře ukazuje Uzamknout, odemčený je. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo vyberte Spotify a zvolte akci, například Toggle Play/Pause. Pak klikněte na Uložit.
Krok 7: Stiskněte tlačítko
Spusťte něco ve Spotify na libovolném zařízení a pak stiskněte tlačítko na decku. Přehrávání se pozastaví nebo obnoví.
Akce18
Umístěte je na tlačítko nebo je spusťte z postupu.
- Play
- Obnoví přehrávání.
- Pause
- Pozastaví přehrávání.
- Toggle Play/Pause
- Přepíná mezi přehráváním a pozastavením a na tlačítku ukazuje stav přehrávání.
- Next Track
- Přeskočí na další skladbu.
- Previous Track
- Přeskočí na předchozí skladbu.
- Refresh State
- Okamžitě se zeptá Spotify na aktuální stav přehrávání.
- Set Volume
- Nastaví hlasitost zařízení, které hraje, v rozsahu 0 až 100 %.
- Volume Up
- Zvýší hlasitost o 10 %.
- Volume Down
- Sníží hlasitost o 10 %.
- Seek
- Přejde na pozici v aktuální skladbě, zadanou v sekundách.
- Toggle Shuffle
- Zapne, vypne nebo přepne náhodné přehrávání a ukazuje, zda je zapnuté.
- Set Repeat Mode
- Nastaví opakování na Off, Repeat Track nebo Repeat Album/Playlist.
- Play Track
- Přehraje skladbu, kterou vyhledáte nebo vyberete z Oblíbených skladeb, nebo vás při spuštění akce požádá o výběr.
- Play Playlist
- Přehraje jeden z vašich playlistů nebo playlist, který vyhledáte, nebo vás při spuštění akce požádá o výběr.
- Play on Device
- Spustí přehrávání na konkrétním zařízení Spotify, nebo vás při spuštění akce požádá o výběr.
- Transfer Playback
- Přesune přehrávání na jiné zařízení a nechá ho hrát nebo pozastavené.
- Přepnout oblíbenou skladbu
- Přidá aktuální skladbu nebo epizodu do Oblíbených skladeb nebo ji z nich odebere a ukazuje, zda je oblíbená.
- Přidat nebo odebrat v playlistu
- Přidá aktuální skladbu nebo epizodu do playlistu nebo ji z něj odebere a ukazuje, zda v playlistu je.
Triggery8
Tlačítko nebo postup může na tyto události reagovat.
- Skladba změněna
- Začala hrát jiná skladba, s názvem, interpretem a albem (v kategorii Music Player).
- Přehrávání spuštěno
- Přehrávání se spustilo nebo pokračovalo (v kategorii Music Player).
- Přehrávání pozastaveno
- Přehrávání bylo pozastaveno (v kategorii Music Player).
- Přehrávání zastaveno
- Přehrávání se zastavilo (v kategorii Music Player).
- Přehrávací zařízení změněno
- Přehrávání se přesunulo na jiné zařízení (v kategorii Music Player).
- Hlasitost změněna
- Hlasitost se změnila, s novou a předchozí hodnotou (v kategorii Music Player).
- Přehrávač připojen
- Spotify je dostupné (v kategorii Music Player).
- Přehrávač odpojen
- Spotify už není dostupné (v kategorii Music Player).
Proměnné19
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
spotify_current_track_name- Název skladby, která hraje.
spotify_current_artist- Interpreti aktuální skladby oddělení čárkami.
spotify_current_album- Album aktuální skladby.
spotify_playback_state- Stav přehrávání:
playing,pausednebostopped. spotify_is_playing- Zda právě hraje hudba.
spotify_volume- Hlasitost v procentech. Můžete ji i nastavovat, například posuvníkem.
spotify_track_duration- Délka aktuální skladby v sekundách.
spotify_current_position- Kolik sekund skladby už se přehrálo. Nastavením hodnoty můžete i přetáčet.
spotify_progress_percentage- Kolik procent skladby už se přehrálo.
spotify_album_art_url- Adresa aktuálního obalu v Macro Deck.
spotify_device_name- Název zařízení, které hraje.
spotify_device_type- Typ zařízení, které hraje, například počítač nebo reproduktor.
spotify_shuffle_enabled- Zda je zapnuté náhodné přehrávání.
spotify_repeat_mode- Režim opakování:
off,tracknebocontext. spotify_is_connected- Zda je Spotify pro Macro Deck dostupné a existuje použitelná relace.
spotify_current_track_url- Odkaz na aktuální skladbu ve Spotify.
spotify_current_track_is_liked- Zda je aktuální skladba v Oblíbených skladbách.
spotify_top_track,spotify_top_artist- Vaše nejčastěji přehrávaná skladba a interpret.
spotify_top_tracks,spotify_top_artists- Vaše nejčastěji přehrávané skladby a interpreti jako seznam.
Widgety1
Přidejte je na svůj deck z výběru widgetů.
- Přehrávač hudby
- Ukazuje skladbu, interprety a obal, které Spotify přehrává, s průběhem a tlačítky pro přehrání, pozastavení a přeskočení.
Často kladené dotazy
Proč potřebuji Spotify Premium?
Spotify povoluje ovládání přehrávání přes Web API jen účtům Premium. S bezplatným účtem Spotify příkazy odmítá a Macro Deck zobrazí na stránce Spotify v části Integrace problém Vyžaduje se Spotify Premium. Je to omezení Spotify, ne Macro Deck.
Proč si musím vytvořit vlastní aplikaci Spotify?
Macro Deck komunikuje se Spotify pomocí Client ID a Client Secret aplikace, kterou vlastníte. Spotify počítá požadavky pro každou aplikaci zvlášť, takže váš deck nesdílí limit s ostatními uživateli. Vytvoření aplikace je zdarma a v Spotify Developer Dashboard zabere minutu.
Musí Spotify běžet na stejném počítači jako Macro Deck?
Ne. Macro Deck ovládá váš účet přes internet, takže ovládá Spotify na jakémkoli zařízení, které pro tento účet hraje, například na telefonu nebo reproduktoru Spotify Connect. Pomocí Play on Device a Transfer Playback zvolíte zařízení.
Můžu připojit víc než jeden účet Spotify?
Ne. Integrace podporuje jednu konfiguraci. Volba Rekonfigurovat ji nahradí jiným účtem a vaše tlačítka a widgety fungují dál.
Macro Deck hlásí, že Spotify omezuje rychlost požadavků. Co s tím?
Spotify přestane odpovídat, když je s přihlašovacími údaji vaší aplikace odesláno příliš mnoho požadavků. Macro Deck své požadavky pozastaví a oznámí, kdy bude pokračovat. Limit zahrnuje všechny aplikace, které používají stejné Client ID, takže obvykle pomůže zavřít ostatní aplikace, které ho používají.
Kde jsou uložené moje přihlašovací údaje ke Spotify?
Client Secret a tokeny, které Spotify vydává, jsou uložené šifrovaně na počítači, na kterém běží Macro Deck. Posílají se jen Spotify. Heslo ke Spotify se do Macro Deck nikdy nezadává; přihlašujete se na webu Spotify.
Další v kategorii Hudba a zvuk
YouTube Music Desktop App
Součást Macro DeckOvládejte YouTube Music Desktop App z decku: přehrávání, hlasitost, hodnocení a to, co právě hraje.
WebNowPlaying
Součást Macro DeckOvládejte hudbu a videa přehrávané v prohlížeči a zobrazujte, co hraje, pomocí rozšíření WebNowPlaying.
Jellyfin
Součást Macro DeckOvládejte aplikace a televize s Jellyfin z decku, zobrazujte, co hraje, a reagujte na spuštění a zastavení přehrávání.
SoundPad
Součást Macro DeckPřehrávejte zvuky ze seznamu SoundPad, ovládejte nahrávání a zobrazujte přehrávaný zvuk na decku.
Voicemeeter
Součást Macro DeckOvládejte hlasitost, ztlumení, směrování a makrotlačítka Voicemeeter, Banana nebo Potato z decku.