SinusBot
Meegeleverd met Macro DeckBedien de muziek van je SinusBot-instanties en toon op je deck wat ze afspelen.
Twee widgets Muziekspeler die een nummer afspelen, een in de stijl Volledige hoes en een in de stijl Kleine hoes, beide met de naam en het logo van SinusBot in de kop
- Afspelen, pauzeren, overslaan en spoelen op elke SinusBot-instantie
- Stel volume, shuffle en herhalen in
- Speel een nummer uit de bibliotheek van de bot af
- Toont het huidige nummer in de widget Muziekspeler
- Voeg zoveel botinstanties toe als je wilt
SinusBot is een muziekbot voor TeamSpeak en Discord die je op je eigen server draait. De integratie SinusBot verbindt Macro Deck met de webinterface van SinusBot, zodat je kunt bepalen wat een botinstantie afspeelt en het huidige nummer op je deck ziet. Ze werkt met elke SinusBot die Macro Deck via het netwerk kan bereiken, op dezelfde computer, in je lokale netwerk of op een server.
Wat je kunt doen
- Afspelen, pauzeren, wisselen, naar het volgende of vorige nummer gaan en naar een positie in het huidige nummer springen.
- Het volume instellen, verhogen of verlagen, shuffle aan- of uitzetten en herhalen aan- of uitzetten.
- Met Play Track een bepaald nummer uit de bibliotheek van de bot afspelen. Laat het nummer leeg om er een te kiezen wanneer je op de knop drukt.
- Het huidige nummer, de artiest en de hoes tonen in de widget Muziekspeler van Macro Deck, en het nummer, de positie en het volume van de bot via variabelen in labels gebruiken.
Een paar voorbeelden:
- Een rij knoppen met Previous Track, Toggle Play/Pause en Next Track voor de bot in je TeamSpeak-kanaal. De afspeelknop toont of de bot afspeelt.
- Een schuifregelaar gekoppeld aan de volumevariabele van de bot,
sinusbot_<instance>_volume, zodat je de muziek zachter kunt zetten terwijl je praat. - Een widget Muziekspeler voor elke bot, naast knoppen waarvan de kleur via de variabele
music_player_<player>_album_colorde hoes volgt.
Meerdere bots en hoe het werkt
Elke SinusBot-instantie die je wilt bedienen, is één configuratie. Je kunt er zoveel toevoegen als je wilt, ook instanties op verschillende servers, en de instantie kiezen in het veld Player van elke actie. Als je Player leeg laat, bedient de actie de eerste. Elke configuratie krijgt een eigen set variabelen, vernoemd naar de naam van de configuratie, zoals sinusbot_<instance>_volume.
Macro Deck controleert de verbinding wanneer je een configuratie instelt en laadt de instanties die de bot heeft. Terwijl het draait, leest het regelmatig de afspeelstatus. Als de bot even niet bereikbaar is, blijft het deck het laatste nummer tonen; blijft hij onbereikbaar, dan is de variabele sinusbot_<instance>_is_connected false en doen acties niets totdat de bot weer antwoordt.
Wat je nodig hebt
- Een draaiende SinusBot met een webinterface die Macro Deck kan bereiken, bijvoorbeeld
http://your-bot:8087. - Een gebruikersnaam en wachtwoord voor SinusBot.
- Minstens één instantie, aangemaakt in de webinterface van SinusBot.
Instellen
Stap 1: Controleer de webinterface van SinusBot
Open de webinterface van SinusBot in een browser en meld je aan. Noteer het adres inclusief de poort, bijvoorbeeld
http://192.168.1.20:8087, en zorg dat er minstens één instantie is.Stap 2: Open de integratie SinusBot
Klik in Macro Deck in de zijbalk op Integraties en daarna op SinusBot. Klik op het tabblad Overzicht in de sectie Configuratie op Configuratie toevoegen. De schakelaar rechtsboven aanzetten opent hetzelfde dialoogvenster, en de integratie wordt ingeschakeld zodra het instellen klaar is.
Stap 3: Vul de server en de aanmelding in
Vul in het dialoogvenster SinusBot verbinden het volgende in:
- Server-URL: het adres van de webinterface van SinusBot, inclusief de poort.
- Gebruikersnaam en Wachtwoord: het account waarmee je je bij SinusBot aanmeldt.
Als je op Doorgaan klikt, test Macro Deck de verbinding en laadt het de instanties.
Stap 4: Selecteer de instantie
Kies bij Instantie selecteren de botinstantie onder Instantie en klik op Doorgaan. De configuratie wordt opgeslagen als SinusBot met de naam van de instantie tussen haakjes. Herhaal deze stappen voor elke andere instantie die je wilt bedienen.
Stap 5: Voeg een actie aan een knop toe
Klik op de pagina Deck op een knop. Het deck moet ontgrendeld zijn: dat is zo wanneer rechtsboven de knop Vergrendelen staat. De editor opent met Kort indrukken geselecteerd. Klik op + Actie toevoegen, selecteer links in het dialoogvenster Actie toevoegen SinusBot, kies Toggle Play/Pause en kies de instantie onder Player.
Stap 6: Druk op de knop
Druk op de knop op je deck. De bot start of pauzeert het afspelen, en de knop toont de huidige status. Een widget Muziekspeler die op de instantie is ingesteld, toont het nummer dat speelt.
Acties13
Zet deze op een knop of voer ze uit vanuit een actiestroom.
- Play
- Hervat het afspelen.
- Pause
- Pauzeert het afspelen.
- Toggle Play/Pause
- Wisselt tussen afspelen en pauzeren en toont de huidige status op de knop.
- Next Track
- Springt naar het volgende nummer.
- Previous Track
- Springt naar het vorige nummer.
- Refresh State
- Leest de huidige afspeelstatus meteen opnieuw.
- Set Volume
- Stelt het afspeelvolume in (0 tot 100%).
- Volume Up
- Verhoogt het afspeelvolume met 10%.
- Volume Down
- Verlaagt het afspeelvolume met 10%.
- Seek
- Springt naar een positie in het huidige nummer, in seconden.
- Toggle Shuffle
- Wisselt shuffle, of zet het aan of uit.
- Set Repeat Mode
- Zet herhalen aan of uit. SinusBot heeft één herhaalmodus, dus beide herhaalopties zetten die aan.
- Play Track
- Speelt een nummer uit de bibliotheek van de bot af. Laat het leeg om een nummer te kiezen wanneer je op de knop drukt.
Triggers7
Een knop of actiestroom kan op deze gebeurtenissen reageren.
- Nummer gewijzigd
- Er is een ander nummer begonnen (onder Muziekspeler).
- Afspelen gestart
- Het afspelen is gestart of hervat (onder Muziekspeler).
- Afspelen gepauzeerd
- Het afspelen is gepauzeerd (onder Muziekspeler).
- Afspelen gestopt
- Het afspelen is gestopt (onder Muziekspeler).
- Volume gewijzigd
- Het volume van de bot is gewijzigd, met de nieuwe en de vorige waarde (onder Muziekspeler).
- Speler verbonden
- De botinstantie is bereikbaar geworden (onder Muziekspeler).
- Speler niet verbonden
- De botinstantie is niet meer bereikbaar (onder Muziekspeler).
Variabelen8
Toon deze waarden op knoppen en widgets, of gebruik ze in voorwaarden.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Het huidige nummer en de artiest. SinusBot geeft geen album door, dus
sinusbot_<instance>_current_albumblijft leeg. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Of de bot afspeelt, gepauzeerd of gestopt is.
sinusbot_<instance>_volume- Het afspeelvolume in procent. Je kunt het ook instellen, bijvoorbeeld met een schuifregelaar.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- De lengte van het nummer en de positie in seconden, en de voortgang in procent. Je kunt de positie instellen om te spoelen.
sinusbot_<instance>_album_art_url- Het adres van de huidige hoes.
sinusbot_<instance>_device_name- De naam van de botinstantie.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Of shuffle en herhalen aan staan.
sinusbot_<instance>_is_connected- Of Macro Deck de botinstantie kan bereiken.
Veelgestelde vragen
Kan ik meer dan één bot bedienen?
Ja. Voeg een configuratie per SinusBot-instantie toe, ook op verschillende servers. Elke actie heeft een veld Player voor de instantie die ze bedient, en elke configuratie heeft eigen variabelen.
Moet SinusBot op dezelfde computer draaien?
Nee. Macro Deck praat via het netwerk met de webinterface van SinusBot, dus de bot kan op een server of een andere computer draaien, zolang Macro Deck het adres kan bereiken.
Het instellen meldt dat er geen instanties zijn gevonden. Wat kan ik doen?
Het account heeft geen instantie die het kan gebruiken. Maak eerst een instantie aan in de webinterface van SinusBot en stel de configuratie daarna opnieuw in.
Wat gebeurt er als de bot offline gaat?
Een korte onderbreking maakt het deck niet leeg: het houdt het laatste nummer nog even vast. Blijft de bot onbereikbaar, dan is de variabele sinusbot_<instance>_is_connected false, en blijft Macro Deck proberen hem te bereiken.
Waar wordt mijn wachtwoord opgeslagen?
Het wachtwoord wordt versleuteld op je computer opgeslagen en alleen gebruikt om je aan te melden bij je SinusBot.
Meer in Chat en spraak
Discord
Meegeleverd met Macro DeckDemp je microfoon en geluid, neem deel aan spraakkanalen, wijzig spraakinstellingen en plaats webhookberichten in Discord vanaf je deck.
Discord-webhooks
Meegeleverd met Macro DeckPlaats uitgebreide berichten met embeds en vermeldingen via webhooks in Discord-kanalen, met een live voorbeeld.