SinusBot
Inclusa in Macro DeckControlla la musica delle tue istanze SinusBot e mostra sul deck cosa stanno riproducendo.
Due widget Lettore musicale che riproducono un brano, uno con lo stile Copertina intera e uno con lo stile Copertina piccola, entrambi con il nome e il logo di SinusBot nell'intestazione
- Riproduci, metti in pausa, salta e spostati nel brano su qualsiasi istanza SinusBot
- Imposta volume, riproduzione casuale e ripetizione
- Riproduci un brano dalla libreria del bot
- Mostra il brano in riproduzione nel widget Lettore musicale
- Aggiungi tutte le istanze del bot che vuoi
SinusBot è un bot musicale per TeamSpeak e Discord che esegui sul tuo server. L'integrazione SinusBot collega Macro Deck all'interfaccia web di SinusBot, così puoi controllare cosa riproduce un'istanza del bot e vedere il brano attuale sul deck. Funziona con qualsiasi SinusBot che Macro Deck può raggiungere attraverso la rete, sullo stesso computer, nella rete locale o su un server.
Cosa puoi fare
- Riproduci, metti in pausa, alterna, passa al brano successivo o precedente e vai a una posizione del brano attuale.
- Imposta il volume, alzalo o abbassalo, attiva o disattiva la riproduzione casuale e la ripetizione.
- Riproduci un brano specifico dalla libreria del bot con Play Track. Lascia vuoto il brano per sceglierne uno quando premi il pulsante.
- Mostra brano, artista e copertina in riproduzione nel widget Lettore musicale di Macro Deck e usa brano, posizione e volume del bot nelle etichette tramite le variabili.
Alcuni esempi di configurazione:
- Una fila di pulsanti con Previous Track, Toggle Play/Pause e Next Track per il bot del tuo canale TeamSpeak. Il pulsante di riproduzione mostra se il bot sta riproducendo.
- Uno slider collegato alla variabile del volume del bot,
sinusbot_<instance>_volume, così puoi abbassare la musica mentre parli. - Un widget Lettore musicale per ogni bot, accanto a pulsanti il cui colore segue la copertina tramite la variabile
music_player_<player>_album_color.
Più bot e come funziona
Ogni istanza SinusBot che vuoi controllare è una configurazione. Puoi aggiungerne quante vuoi, anche istanze su server diversi, e scegliere l'istanza nel campo Player di ogni azione. Se lasci vuoto Player, l'azione controlla la prima. Ogni configurazione riceve il proprio insieme di variabili, con il nome della configurazione, come sinusbot_<instance>_volume.
Macro Deck verifica la connessione quando imposti una configurazione e carica le istanze del bot. Durante il funzionamento legge regolarmente lo stato della riproduzione. Quando il bot non è raggiungibile per un breve momento, il deck continua a mostrare l'ultimo brano; quando resta irraggiungibile, la variabile sinusbot_<instance>_is_connected vale false e le azioni non fanno nulla finché il bot non risponde di nuovo.
Cosa ti serve
- Un SinusBot in esecuzione con un'interfaccia web che Macro Deck può raggiungere, per esempio
http://your-bot:8087. - Un nome utente e una password di SinusBot.
- Almeno un'istanza creata nell'interfaccia web di SinusBot.
Configurala
Passaggio 1: Controlla l'interfaccia web di SinusBot
Apri l'interfaccia web di SinusBot in un browser e accedi. Annota l'indirizzo compresa la porta, per esempio
http://192.168.1.20:8087, e assicurati che ci sia almeno un'istanza.Passaggio 2: Apri l'integrazione SinusBot
In Macro Deck, fai clic su Integrazioni nella barra laterale e poi su SinusBot. Nella scheda Panoramica, fai clic su Aggiungi configurazione nella sezione Configurazione. Attivando l'interruttore in alto a destra si apre la stessa finestra, e l'integrazione si attiva al termine della configurazione.
Passaggio 3: Inserisci server e dati di accesso
Nella finestra Connetti SinusBot, inserisci:
- URL del server: l'indirizzo dell'interfaccia web di SinusBot, compresa la porta.
- Nome utente e Password: l'account con cui accedi a SinusBot.
Quando fai clic su Continua, Macro Deck prova la connessione e carica le istanze.
Passaggio 4: Seleziona l'istanza
In Seleziona istanza, scegli l'istanza del bot in Istanza e fai clic su Continua. La configurazione viene salvata come SinusBot con il nome dell'istanza tra parentesi. Ripeti questi passaggi per ogni altra istanza che vuoi controllare.
Passaggio 5: Aggiungi un'azione a un pulsante
Nella pagina Deck, fai clic su un pulsante. Il deck deve essere sbloccato: se in alto a destra compare il pulsante Blocca, lo è. L'editor si apre con Pressione Breve selezionata. Fai clic su + Aggiungi azione, seleziona SinusBot a sinistra nella finestra Aggiungi azione, scegli Toggle Play/Pause e seleziona l'istanza in Player.
Passaggio 6: Premi il pulsante
Premi il pulsante sul deck. Il bot avvia o mette in pausa la riproduzione e il pulsante mostra lo stato attuale. Un widget Lettore musicale impostato sull'istanza mostra il brano in riproduzione.
Azioni13
Assegnale a un pulsante o eseguile da un flusso.
- Play
- Riprende la riproduzione.
- Pause
- Mette in pausa la riproduzione.
- Toggle Play/Pause
- Alterna tra riproduzione e pausa e mostra lo stato attuale sul pulsante.
- Next Track
- Passa al brano successivo.
- Previous Track
- Torna al brano precedente.
- Refresh State
- Rilegge subito lo stato di ciò che è in riproduzione.
- Set Volume
- Imposta il volume di riproduzione (da 0 a 100%).
- Volume Up
- Alza il volume di riproduzione del 10%.
- Volume Down
- Abbassa il volume di riproduzione del 10%.
- Seek
- Va a una posizione del brano attuale, in secondi.
- Toggle Shuffle
- Alterna la riproduzione casuale, oppure la attiva o la disattiva.
- Set Repeat Mode
- Attiva o disattiva la ripetizione. SinusBot ha una sola modalità di ripetizione, quindi entrambe le opzioni di ripetizione la attivano.
- Play Track
- Riproduce un brano dalla libreria del bot. Lascialo vuoto per scegliere un brano quando premi il pulsante.
Trigger7
Un pulsante o un flusso può reagire a questi eventi.
- Brano cambiato
- È iniziato un altro brano (in Music Player).
- Riproduzione avviata
- La riproduzione è iniziata o è ripresa (in Music Player).
- Riproduzione in pausa
- La riproduzione è stata messa in pausa (in Music Player).
- Riproduzione interrotta
- La riproduzione si è interrotta (in Music Player).
- Volume cambiato
- Il volume del bot è cambiato, con il valore nuovo e quello precedente (in Music Player).
- Player connesso
- L'istanza del bot è diventata raggiungibile (in Music Player).
- Player disconnesso
- L'istanza del bot non è più raggiungibile (in Music Player).
Variabili8
Mostra questi valori su pulsanti e widget o usali nelle condizioni.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Il brano attuale e il suo artista. SinusBot non riporta un album, quindi
sinusbot_<instance>_current_albumresta vuota. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Indica se il bot sta riproducendo, è in pausa o è fermo.
sinusbot_<instance>_volume- Il volume di riproduzione in percentuale. Puoi anche impostarlo, per esempio con uno slider.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- La durata del brano e la posizione in secondi, e l'avanzamento in percentuale. Puoi impostare la posizione per spostarti nel brano.
sinusbot_<instance>_album_art_url- L'indirizzo della copertina attuale.
sinusbot_<instance>_device_name- Il nome dell'istanza del bot.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Indica se riproduzione casuale e ripetizione sono attive.
sinusbot_<instance>_is_connected- Indica se Macro Deck riesce a raggiungere l'istanza del bot.
Domande frequenti
Posso controllare più di un bot?
Sì. Aggiungi una configurazione per ogni istanza SinusBot, anche su server diversi. Ogni azione ha un campo Player per l'istanza che controlla e ogni configurazione ha le proprie variabili.
SinusBot deve girare sullo stesso computer?
No. Macro Deck comunica con l'interfaccia web di SinusBot attraverso la rete, quindi il bot può girare su un server o su un altro computer, purché Macro Deck possa raggiungerne l'indirizzo.
La configurazione dice che non sono state trovate istanze. Cosa posso fare?
L'account non ha nessuna istanza che può usare. Crea prima un'istanza nell'interfaccia web di SinusBot, poi esegui di nuovo la configurazione.
Cosa succede quando il bot va offline?
Una breve interruzione non svuota il deck: conserva l'ultimo brano per un momento. Quando il bot resta irraggiungibile, la variabile sinusbot_<instance>_is_connected vale false e Macro Deck continua a provare a raggiungerlo.
Dove viene salvata la mia password?
La password viene salvata in modo crittografato sul computer e usata solo per accedere al tuo SinusBot.
Altro in Chat e voce
Discord
Inclusa in Macro DeckSilenzia il microfono, disattiva l'audio, entra nei canali vocali, cambia le impostazioni vocali e invia messaggi webhook in Discord dal deck.
Webhook Discord
Inclusa in Macro DeckPubblica messaggi ricchi con embed e menzioni nei canali Discord tramite webhook, con un'anteprima in tempo reale.