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.
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 YouTube Music Desktop App w nagłówku
- Odtwarzanie, wstrzymanie, przełączanie, przewijanie, odtwarzanie losowe, powtarzanie i głośność
- Polubienie, oznaczenie jako nielubiany lub wyczyszczenie oceny bieżącego utworu
- Uruchamianie filmu lub playlisty z linku lub identyfikatora
- Aktualizacje na żywo przez Companion Server aplikacji
- Widżet Odtwarzacz muzyki i zmienne dla utworu, wykonawcy i postępu
Integracja YouTube Music Desktop App łączy Macro Deck z YouTube Music Desktop App (YTMDesktop), aplikacją komputerową dla YouTube Music. Korzysta z Companion Server aplikacji, wbudowanego w wersję 2.0.6 i nowsze. Wystarczy raz zezwolić Macro Deck w aplikacji, a od tej pory łączy się on sam, gdy tylko aplikacja działa.
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.
- Wyciszanie aplikacji i wyłączanie wyciszenia.
- Polubienie lub oznaczenie bieżącego utworu jako nielubianego, wyczyszczenie jego oceny albo przełączanie polubienia lub braku polubienia.
- Uruchamianie utworu z bieżącej kolejki lub z jednej z playlist albo wybór przy naciśnięciu przycisku.
- Uruchamianie konkretnego filmu lub playlisty z linku YouTube Music, linku youtu.be, identyfikatora filmu lub identyfikatora playlisty.
- Wyświetlanie bieżącego odtwarzania w widżecie Odtwarzacz muzyki z okładką, postępem oraz przyciskami odtwarzania i przełączania.
- Reagowanie przebiegiem, gdy utwór zostanie polubiony, oznaczony jako nielubiany lub jego ocena zostanie wyczyszczona.
Przykładowe zastosowania:
- Przycisk Toggle Play/Pause, który pokazuje, czy muzyka jest odtwarzana, czy wstrzymana.
- Przycisk polubienia z akcją Oceń utwór w trybie Przełącz „lubię to”, z etykietą powiązaną z
ytmdesktop_like_status. - Przycisk z akcją Odtwórz film lub URL, który uruchamia playlistę do skupienia z jej linku YouTube Music.
- Suwak powiązany z
ytmdesktop_volume, który nadąża za głośnością aplikacji i zmienia ją podczas przeciągania.
Działanie
Macro Deck utrzymuje połączenie na żywo z Companion Server, więc zmiany wprowadzone w aplikacji od razu pojawiają się na decku. Po zamknięciu aplikacji Macro Deck ponawia próbę po 5 sekundach i po każdej nieudanej próbie czeka dłużej, maksymalnie minutę. Zmienna ytmdesktop_is_connected pokazuje, czy aplikacja jest osiągalna. Jeśli dostęp zostanie usunięty w aplikacji, problem YouTube Music Desktop App odrzucił autoryzację na stronie integracji poprosi o ponowne uruchomienie konfiguracji. Domyślnie Macro Deck szuka aplikacji na tym samym komputerze. W sekcji Konfiguracja zaawansowana w oknie konfiguracji można wpisać adres innego komputera. Można skonfigurować jedną YouTube Music Desktop App.
Czego potrzebujesz
- YouTube Music Desktop App 2.0.6 lub nowsza. Wersja 1 nie ma Companion Server.
- Companion Server włączony w aplikacji w Ustawienia > Integracje.
- Companion Authorization włączone podczas konfigurowania Macro Deck.
Konfiguracja krok po kroku
Krok 1: Zainstaluj YouTube Music Desktop App
Zainstaluj YouTube Music Desktop App 2.0.6 lub nowszą i uruchom ją. Okno konfiguracji w Macro Deck zawiera link do strony z wydaniami aplikacji.
Krok 2: Włącz Companion Server
W YouTube Music Desktop App przejdź do Ustawienia > Integracje. Włącz Companion Server i Companion Authorization. Po zezwoleniu Macro Deck aplikacja sama ponownie wyłącza autoryzację.
Krok 3: Rozpocznij konfigurację w Macro Deck
W Macro Deck kliknij Integracje na pasku bocznym, a następnie YouTube Music Desktop App. 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 Włącz Companion Server nie ma pól do wypełnienia. Jeśli aplikacja działa na innym komputerze, włącz Konfiguracja zaawansowana i wpisz jego adres w polu Adres. Pozostaw Port ustawiony na
9863. Kliknij Dalej.Krok 4: Zezwól na Macro Deck w aplikacji
Okno pokazuje teraz krok Zezwól na Macro Deck z polem Kod autoryzacji. Kliknij Dalej: w YouTube Music Desktop App otworzy się okno zatwierdzania z Macro Deck i kodem. Sprawdź, czy kody się zgadzają, i w ciągu 30 sekund kliknij Zezwól. Gdy okno w Macro Deck pokaże Konfiguracja zakończona., kliknij Gotowe.
Krok 5: 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 YouTube Music Desktop App i wybierz akcję, np. Toggle Play/Pause lub Oceń utwór. Następnie kliknij Zapisz.
Krok 6: Naciśnij przycisk
Uruchom utwór w YouTube Music Desktop App i naciśnij przycisk na decku. Odtwarzanie zostanie wstrzymane lub wznowione.
Akcje17
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 odczytuje bieżący stan odtwarzania.
- Set Volume
- Ustawia głośność aplikacji 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 utwór z bieżącej kolejki albo prosi o wybór przy uruchomieniu akcji.
- Play Playlist
- Odtwarza jedną z playlist albo prosi o wybór przy uruchomieniu akcji.
- Oceń utwór
- Oznacza bieżący utwór jako polubiony lub nielubiany, czyści jego ocenę albo przełącza polubienie lub brak polubienia.
- Wycisz
- Wycisza aplikację, wyłącza jej wyciszenie lub je przełącza.
- Odtwórz film lub URL
- Uruchamia film lub playlistę z linku YouTube Music, linku youtu.be, identyfikatora filmu lub identyfikatora playlisty.
Wyzwalacze8
Przycisk lub przebieg może reagować na te zdarzenia.
- Zmiana oceny
- Bieżący utwór został polubiony, oznaczony jako nielubiany lub jego ocena została wyczyszczona, opcjonalnie tylko dla jednej oceny.
- 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).
- Głośność zmieniona
- Głośność się zmieniła, wraz z nową i poprzednią wartością (w grupie Music Player).
- Odtwarzacz połączony
- Aplikacja stała się osiągalna (w grupie Music Player).
- Odtwarzacz rozłączony
- Aplikacja nie jest już osiągalna (w grupie Music Player).
Zmienne21
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
ytmdesktop_is_connected- Czy Macro Deck jest połączony z aplikacją.
ytmdesktop_current_track_name- Tytuł bieżącego utworu.
ytmdesktop_current_artist- Wykonawca bieżącego utworu.
ytmdesktop_current_album- Album bieżącego utworu.
ytmdesktop_album_art_url- Adres bieżącej okładki w Macro Deck.
ytmdesktop_playback_state- Stan odtwarzania:
playing,pausedlubstopped. ytmdesktop_is_playing- Czy muzyka jest teraz odtwarzana.
ytmdesktop_current_position- Czas odtworzenia utworu w sekundach. Ustawienie tej wartości przewija utwór.
ytmdesktop_track_duration- Długość bieżącego utworu w sekundach.
ytmdesktop_progress_percentage- Postęp odtwarzania utworu w procentach.
ytmdesktop_volume- Głośność aplikacji w procentach. Można ją też ustawiać, np. suwakiem.
ytmdesktop_is_muted- Czy aplikacja jest wyciszona.
ytmdesktop_like_status- Ocena bieżącego utworu:
like,dislikelubindifferent. ytmdesktop_is_liked- Czy bieżący utwór jest polubiony.
ytmdesktop_shuffle_enabled- Czy odtwarzanie losowe jest włączone.
ytmdesktop_repeat_mode- Tryb powtarzania:
off,tracklubcontext. ytmdesktop_is_live- Czy bieżąca pozycja to transmisja na żywo.
ytmdesktop_media_type- Rodzaj bieżącej pozycji:
audio,video,uploadedlubpodcast. ytmdesktop_ad_playing- Czy właśnie odtwarzana jest reklama.
ytmdesktop_video_id- Identyfikator YouTube bieżącego utworu.
ytmdesktop_device_name- Nazwa wyświetlana jako źródło odtwarzania.
Widżety1
Dodaj je do decku z selektora widżetów.
- Odtwarzacz muzyki
- Pokazuje utwór, wykonawcę i okładkę odtwarzane przez YouTube Music Desktop App, z postępem oraz przyciskami odtwarzania, wstrzymania i przełączania.
Najczęściej zadawane pytania
Czy to działa z YouTube Music w przeglądarce?
Nie. Ta integracja komunikuje się tylko z YouTube Music Desktop App. Dla YouTube Music w karcie przeglądarki użyj integracji WebNowPlaying z jej rozszerzeniem przeglądarki.
Czy Macro Deck może sterować aplikacją na innym komputerze?
Tak. Podczas konfiguracji włącz Konfiguracja zaawansowana i wpisz w polu Adres adres komputera, na którym działa YouTube Music Desktop App.
Konfiguracja informuje, że nie można połączyć się z aplikacją. Co zrobić?
Sprawdź, czy YouTube Music Desktop App działa, czy ma wersję 2.0.6 lub nowszą i czy Companion Server jest włączony w Ustawienia > Integracje. Następnie ponownie kliknij Dalej.
Dlaczego konfiguracja prosi o ponowne włączenie Companion Authorization?
Aplikacja przyjmuje nowe żądania autoryzacji tylko wtedy, gdy Companion Authorization jest włączone, i sama je wyłącza po zezwoleniu aplikacji. Włącz je, kliknij Dalej i w ciągu 30 sekund kliknij Zezwól.
Co się dzieje po zamknięciu aplikacji?
Zmienna ytmdesktop_is_connected ma wartość false, widżet Odtwarzacz muzyki pokazuje, że YouTube Music nie działa, a akcje kończą się komunikatem, że aplikacja nie jest połączona. Po ponownym uruchomieniu aplikacji Macro Deck sam łączy się ponownie w ciągu minuty.
Więcej w kategorii Muzyka i dźwięk
Spotify
Dołączona do Macro DeckSteruj odtwarzaniem Spotify, oznaczaj utwory jako polubione, zarządzaj playlistami i pokazuj na decku, co jest odtwarzane.
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.