SinusBot
Součást Macro DeckOvládejte hudbu svých instancí SinusBot a zobrazujte na decku, co hrají.
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 SinusBot v záhlaví
- Přehrávání, pozastavení, přeskakování a přetáčení na libovolné instanci SinusBot
- Nastavení hlasitosti, náhodného přehrávání a opakování
- Přehrání skladby z knihovny bota
- Zobrazení přehrávané skladby ve widgetu Přehrávač hudby
- Přidejte libovolný počet instancí bota
SinusBot je hudební bot pro TeamSpeak a Discord, který provozujete na vlastním serveru. Integrace SinusBot propojuje Macro Deck s webovým rozhraním SinusBot, takže můžete ovládat, co instance bota přehrává, a vidět aktuální skladbu na decku. Funguje s jakýmkoli SinusBotem, který je pro Macro Deck dostupný přes síť: na stejném počítači, v lokální síti nebo na serveru.
Co můžete dělat
- Přehrát, pozastavit, přepnout, přeskočit na další nebo předchozí skladbu a přejít na pozici v aktuální skladbě.
- Nastavit hlasitost, zvýšit ji nebo snížit a zapnout či vypnout náhodné přehrávání a opakování.
- Přehrát konkrétní skladbu z knihovny bota pomocí Play Track. Když skladbu necháte prázdnou, vyberete ji při stisknutí tlačítka.
- Zobrazit přehrávanou skladbu, interpreta a obal ve widgetu Přehrávač hudby v Macro Deck a pomocí proměnných používat skladbu, pozici a hlasitost bota v popiscích.
Několik příkladů použití:
- Řada tlačítek s Previous Track, Toggle Play/Pause a Next Track pro bota ve vašem kanálu TeamSpeak. Tlačítko přehrávání ukazuje, zda bot hraje.
- Posuvník propojený s proměnnou hlasitosti bota,
sinusbot_<instance>_volume, takže můžete hudbu ztlumit, když mluvíte. - Widget Přehrávač hudby pro každého bota vedle tlačítek, jejichž barva se pomocí proměnné
music_player_<player>_album_colorřídí obalem.
Více botů a jak se integrace chová
Každá instance SinusBot, kterou chcete ovládat, je jedna konfigurace. Můžete jich přidat libovolný počet, i instance na různých serverech, a instanci vybrat v poli Player každé akce. Když pole Player necháte prázdné, akce ovládá první z nich. Každá konfigurace má vlastní sadu proměnných pojmenovaných podle názvu konfigurace, například sinusbot_<instance>_volume.
Macro Deck při nastavení konfigurace zkontroluje připojení a načte instance, které bot má. Za běhu pravidelně čte stav přehrávání. Když bot na krátkou chvíli není dostupný, deck dál ukazuje poslední skladbu; když zůstane nedostupný, proměnná sinusbot_<instance>_is_connected má hodnotu false a akce nic nedělají, dokud bot znovu neodpoví.
Co budete potřebovat
- Běžící SinusBot, jehož webové rozhraní je pro Macro Deck dostupné, například
http://your-bot:8087. - Uživatelské jméno a heslo pro SinusBot.
- Alespoň jedna instance vytvořená ve webovém rozhraní SinusBot.
Nastavení
Krok 1: Zkontrolujte webové rozhraní SinusBot
Otevřete webové rozhraní SinusBot v prohlížeči a přihlaste se. Poznamenejte si adresu včetně portu, například
http://192.168.1.20:8087, a ujistěte se, že existuje alespoň jedna instance.Krok 2: Otevřete integraci SinusBot
V Macro Deck klikněte na postranním panelu na Integrace a pak na SinusBot. Na kartě Přehled klikněte v části Konfigurace na Přidat konfiguraci. Stejný dialog otevře i přepínač vpravo nahoře; po dokončení nastavení se integrace zapne.
Krok 3: Zadejte server a přihlašovací údaje
V dialogu Připojit SinusBot zadejte:
- URL serveru: adresa webového rozhraní SinusBot včetně portu.
- Uživatelské jméno a Heslo: účet, kterým se do SinusBot přihlašujete.
Když kliknete na Pokračovat, Macro Deck otestuje připojení a načte instance.
Krok 4: Vyberte instanci
V kroku Vybrat instanci zvolte v poli Instance instanci bota a klikněte na Pokračovat. Konfigurace se uloží jako SinusBot s názvem instance v závorce. Tyto kroky zopakujte pro každou další instanci, kterou chcete ovládat.
Krok 5: Přidejte akci na tlačítko
Na stránce Deck klikněte na tlačítko. Deck musí být odemčený: pokud se vpravo nahoře zobrazuje tlačítko 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 SinusBot, zvolte Toggle Play/Pause a v poli Player vyberte instanci.
Krok 6: Stiskněte tlačítko
Stiskněte tlačítko na decku. Bot spustí nebo pozastaví přehrávání a tlačítko ukazuje aktuální stav. Widget Přehrávač hudby nastavený na tuto instanci ukazuje přehrávanou skladbu.
Akce13
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 aktuální stav.
- Next Track
- Přeskočí na další skladbu.
- Previous Track
- Přeskočí na předchozí skladbu.
- Refresh State
- Okamžitě znovu načte stav právě přehrávané skladby.
- Set Volume
- Nastaví hlasitost přehrávání (0 až 100 %).
- Volume Up
- Zvýší hlasitost přehrávání o 10 %.
- Volume Down
- Sníží hlasitost přehrávání o 10 %.
- Seek
- Přejde na pozici v aktuální skladbě, zadanou v sekundách.
- Toggle Shuffle
- Přepne náhodné přehrávání, nebo ho zapne či vypne.
- Set Repeat Mode
- Zapne nebo vypne opakování. SinusBot má jen jeden režim opakování, takže obě možnosti opakování ho zapnou.
- Play Track
- Přehraje skladbu z knihovny bota. Když ji necháte prázdnou, vyberete skladbu při stisknutí tlačítka.
Triggery7
Tlačítko nebo postup může na tyto události reagovat.
- Skladba změněna
- Začala hrát jiná skladba (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).
- Hlasitost změněna
- Hlasitost bota se změnila, s novou a předchozí hodnotou (v kategorii Music Player).
- Přehrávač připojen
- Instance bota je dostupná (v kategorii Music Player).
- Přehrávač odpojen
- Instance bota už není dostupná (v kategorii Music Player).
Proměnné8
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Aktuální skladba a její interpret. SinusBot album nehlásí, takže
sinusbot_<instance>_current_albumzůstává prázdná. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Zda bot přehrává, je pozastavený nebo zastavený.
sinusbot_<instance>_volume- Hlasitost přehrávání v procentech. Můžete ji i nastavovat, například posuvníkem.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- Délka skladby a pozice v sekundách a průběh v procentech. Nastavením pozice můžete přetáčet.
sinusbot_<instance>_album_art_url- Adresa aktuálního obalu.
sinusbot_<instance>_device_name- Název instance bota.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Zda je zapnuté náhodné přehrávání a opakování.
sinusbot_<instance>_is_connected- Zda je instance bota pro Macro Deck dostupná.
Často kladené dotazy
Můžu ovládat víc než jednoho bota?
Ano. Přidejte jednu konfiguraci pro každou instanci SinusBot, i na různých serverech. Každá akce má pole Player pro instanci, kterou ovládá, a každá konfigurace má vlastní proměnné.
Musí SinusBot běžet na stejném počítači?
Ne. Macro Deck komunikuje s webovým rozhraním SinusBot přes síť, takže bot může běžet na serveru nebo jiném počítači, pokud je jeho adresa pro Macro Deck dostupná.
Nastavení hlásí, že nebyly nalezeny žádné instance. Co s tím?
Účet nemá žádnou instanci, kterou by mohl používat. Nejdřív vytvořte instanci ve webovém rozhraní SinusBot a pak konfiguraci nastavte znovu.
Co se stane, když bot přejde do režimu offline?
Krátký výpadek deck nevymaže: chvíli si ponechá poslední skladbu. Když bot zůstane nedostupný, proměnná sinusbot_<instance>_is_connected má hodnotu false a Macro Deck se ho dál pokouší zastihnout.
Kde je uložené moje heslo?
Heslo je uložené šifrovaně ve vašem počítači a používá se jen k přihlášení k vašemu SinusBot.
Další v kategorii Chat a hlas
Discord
Součást Macro DeckZtlumujte se, ohlušujte se, připojujte se k hlasovým kanálům, měňte nastavení hlasu a posílejte zprávy přes webhooky v Discordu přímo z decku.
Webhooky Discordu
Součást Macro DeckPosílejte do kanálů na Discordu bohaté zprávy s embedy a zmínkami přes webhooky, s živým náhledem.