SinusBot
Dołączona do Macro DeckSteruj muzyką instancji SinusBot i pokazuj na decku, co odtwarzają.
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 SinusBot w nagłówku
- Odtwarzanie, wstrzymywanie, przełączanie i przewijanie na dowolnej instancji SinusBot
- Ustawianie głośności, odtwarzania losowego i powtarzania
- Odtwarzanie utworu z biblioteki bota
- Bieżący utwór w widżecie Odtwarzacz muzyki
- Dowolna liczba dodanych instancji bota
SinusBot to bot muzyczny dla TeamSpeak i Discorda, uruchamiany na własnym serwerze. Integracja SinusBot łączy Macro Deck z interfejsem webowym SinusBot, dzięki czemu można sterować tym, co odtwarza instancja bota, i widzieć bieżący utwór na decku. Działa z każdym SinusBotem, z którym Macro Deck może się połączyć przez sieć: na tym samym komputerze, w sieci lokalnej lub na serwerze.
Możliwości
- Odtwarzanie, wstrzymywanie, przełączanie, przechodzenie do następnego lub poprzedniego utworu i przeskakiwanie do wybranego miejsca bieżącego utworu.
- Ustawianie, zwiększanie i zmniejszanie głośności oraz włączanie i wyłączanie odtwarzania losowego i powtarzania.
- Odtwarzanie konkretnego utworu z biblioteki bota akcją Play Track. Jeśli utwór pozostanie pusty, wybiera się go przy naciśnięciu przycisku.
- Wyświetlanie bieżącego utworu, wykonawcy i okładki w widżecie Odtwarzacz muzyki w Macro Deck oraz używanie utworu, pozycji i głośności bota w etykietach za pomocą zmiennych.
Przykładowe zastosowania:
- Rząd przycisków z akcjami Previous Track, Toggle Play/Pause i Next Track dla bota na kanale TeamSpeak. Przycisk odtwarzania pokazuje, czy bot odtwarza.
- Suwak powiązany ze zmienną głośności bota,
sinusbot_<instance>_volume, który pozwala ściszyć muzykę podczas rozmowy. - Widżet Odtwarzacz muzyki dla każdego bota obok przycisków, których kolor dopasowuje się do okładki za pomocą zmiennej
music_player_<player>_album_color.
Wiele botów i działanie
Każda instancja SinusBot, która ma być sterowana, to osobna konfiguracja. Można dodać dowolną liczbę, także instancje na różnych serwerach, i wybierać instancję w polu Player każdej akcji. Gdy pole Player pozostanie puste, akcja steruje pierwszą instancją. Każda konfiguracja otrzymuje własny zestaw zmiennych, nazwanych według nazwy konfiguracji, np. sinusbot_<instance>_volume.
Macro Deck sprawdza połączenie podczas konfigurowania i wczytuje instancje bota. W trakcie działania regularnie odczytuje stan odtwarzania. Gdy bot jest na krótko nieosiągalny, deck nadal pokazuje ostatni utwór; gdy pozostaje nieosiągalny, zmienna sinusbot_<instance>_is_connected ma wartość false, a akcje nic nie robią, dopóki bot znów nie odpowie.
Czego potrzebujesz
- Działający SinusBot, którego interfejs webowy jest osiągalny dla Macro Deck, np.
http://your-bot:8087. - Nazwa użytkownika i hasło SinusBot.
- Co najmniej jedna instancja utworzona w interfejsie webowym SinusBot.
Konfiguracja krok po kroku
Krok 1: Sprawdź interfejs webowy SinusBot
Otwórz interfejs webowy SinusBot w przeglądarce i zaloguj się. Zanotuj adres wraz z portem, np.
http://192.168.1.20:8087, i upewnij się, że istnieje co najmniej jedna instancja.Krok 2: Otwórz integrację SinusBot
W Macro Deck kliknij Integracje na pasku bocznym, a następnie SinusBot. Na karcie Przegląd kliknij Dodaj konfigurację 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.
Krok 3: Wprowadź serwer i dane logowania
W oknie Połącz z SinusBot wprowadź:
- Adres URL serwera: adres interfejsu webowego SinusBot wraz z portem.
- Nazwa użytkownika i Hasło: konto używane do logowania w SinusBot.
Po kliknięciu Dalej Macro Deck przetestuje połączenie i wczyta instancje.
Krok 4: Wybierz instancję
W kroku Wybierz instancję wybierz instancję bota w polu Instancja i kliknij Dalej. Konfiguracja zostanie zapisana jako SinusBot z nazwą instancji w nawiasie. Powtórz te kroki dla każdej kolejnej instancji, która ma być sterowana.
Krok 5: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk. Deck musi być odblokowany: jest odblokowany, gdy w prawym górnym rogu widać przycisk Zablokuj. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz SinusBot, wybierz Toggle Play/Pause i wskaż instancję w polu Player.
Krok 6: Naciśnij przycisk
Naciśnij przycisk na decku. Bot rozpocznie lub wstrzyma odtwarzanie, a przycisk pokaże bieżący stan. Widżet Odtwarzacz muzyki ustawiony na tę instancję pokazuje odtwarzany utwór.
Akcje13
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 bieżący stan na przycisku.
- Next Track
- Przechodzi do następnego utworu.
- Previous Track
- Przechodzi do poprzedniego utworu.
- Refresh State
- Od razu ponownie odczytuje stan bieżącego odtwarzania.
- Set Volume
- Ustawia głośność odtwarzania (od 0 do 100%).
- Volume Up
- Zwiększa głośność odtwarzania o 10%.
- Volume Down
- Zmniejsza głośność odtwarzania o 10%.
- Seek
- Przeskakuje do wybranego miejsca bieżącego utworu, w sekundach.
- Toggle Shuffle
- Przełącza odtwarzanie losowe albo je włącza lub wyłącza.
- Set Repeat Mode
- Włącza lub wyłącza powtarzanie. SinusBot ma jeden tryb powtarzania, więc obie opcje powtarzania go włączają.
- Play Track
- Odtwarza utwór z biblioteki bota. Jeśli pole pozostanie puste, utwór wybiera się przy naciśnięciu przycisku.
Wyzwalacze7
Przycisk lub przebieg może reagować na te zdarzenia.
- Utwór zmieniony
- Zaczął być odtwarzany inny utwór (w grupie Music Player).
- Odtwarzanie rozpoczęte
- Odtwarzanie zostało rozpoczęte lub 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ść bota się zmieniła, wraz z nową i poprzednią wartością (w grupie Music Player).
- Odtwarzacz połączony
- Instancja bota stała się osiągalna (w grupie Music Player).
- Odtwarzacz rozłączony
- Instancja bota nie jest już osiągalna (w grupie Music Player).
Zmienne8
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Bieżący utwór i jego wykonawca. SinusBot nie zgłasza albumu, więc
sinusbot_<instance>_current_albumpozostaje pusta. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Czy bot odtwarza, wstrzymał odtwarzanie, czy je zatrzymał.
sinusbot_<instance>_volume- Głośność odtwarzania w procentach. Można ją też ustawiać, np. suwakiem.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- Długość utworu i pozycja w sekundach oraz postęp w procentach. Ustawienie pozycji przewija utwór.
sinusbot_<instance>_album_art_url- Adres bieżącej okładki.
sinusbot_<instance>_device_name- Nazwa instancji bota.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Czy odtwarzanie losowe i powtarzanie są włączone.
sinusbot_<instance>_is_connected- Czy Macro Deck może połączyć się z instancją bota.
Najczęściej zadawane pytania
Czy mogę sterować więcej niż jednym botem?
Tak. Dodaj osobną konfigurację dla każdej instancji SinusBot, także na różnych serwerach. Każda akcja ma pole Player do wyboru instancji, którą steruje, a każda konfiguracja ma własne zmienne.
Czy SinusBot musi działać na tym samym komputerze?
Nie. Macro Deck komunikuje się z interfejsem webowym SinusBot przez sieć, więc bot może działać na serwerze lub innym komputerze, o ile Macro Deck może połączyć się z jego adresem.
Konfiguracja informuje, że nie znaleziono instancji. Co zrobić?
Konto nie ma żadnej instancji, z której może korzystać. Najpierw utwórz instancję w interfejsie webowym SinusBot, a następnie ponownie skonfiguruj integrację.
Co się dzieje, gdy bot przejdzie w tryb offline?
Krótka przerwa nie czyści decku: przez chwilę pozostaje na nim ostatni utwór. Gdy bot pozostaje nieosiągalny, zmienna sinusbot_<instance>_is_connected ma wartość false, a Macro Deck ponawia próby połączenia.
Gdzie jest przechowywane moje hasło?
Hasło jest przechowywane w postaci zaszyfrowanej na komputerze i służy wyłącznie do logowania w SinusBot.
Więcej w kategorii Czat i głos
Discord
Dołączona do Macro DeckWyciszaj się, ogłuszaj, dołączaj do kanałów głosowych, zmieniaj ustawienia głosu i publikuj wiadomości przez webhooki w Discordzie z decku.
Webhooki Discorda
Dołączona do Macro DeckPublikuj rozbudowane wiadomości z embedami i wzmiankami na kanałach Discorda przez webhooki, z podglądem na żywo.