SinusBot
Incluída no Macro DeckControle a música das suas instâncias do SinusBot e mostre no deck o que elas estão tocando.
Dois widgets Reprodutor de música tocando uma faixa, um no estilo Capa completa e outro no estilo Capa pequena, ambos com o nome e o logotipo do SinusBot no cabeçalho
- Reproduza, pause, pule e avance em qualquer instância do SinusBot
- Ajuste o volume, a reprodução aleatória e a repetição
- Toque uma faixa da biblioteca do bot
- Mostra a faixa atual no widget Reprodutor de música
- Adicione quantas instâncias do bot quiser
O SinusBot é um bot de música para TeamSpeak e Discord que roda no seu próprio servidor. A integração SinusBot conecta o Macro Deck à interface web do SinusBot, para controlar o que uma instância do bot toca e ver a faixa atual no deck. Ela funciona com qualquer SinusBot que o Macro Deck consiga alcançar pela rede, no mesmo computador, na rede local ou em um servidor.
O que dá para fazer
- Reproduza, pause, alterne, pule para a próxima faixa ou para a anterior e vá para uma posição da faixa atual.
- Defina o volume, aumente ou diminua, ative ou desative a reprodução aleatória e a repetição.
- Toque uma faixa específica da biblioteca do bot com Play Track. Deixe a faixa vazia para escolher uma ao pressionar o botão.
- Mostre a faixa atual, o artista e a capa no widget Reprodutor de música do Macro Deck, e use a faixa, a posição e o volume do bot em rótulos por meio de variáveis.
Alguns exemplos de uso:
- Uma fileira de botões com Previous Track, Toggle Play/Pause e Next Track para o bot do seu canal do TeamSpeak. O botão de reprodução mostra se o bot está tocando.
- Um controle deslizante vinculado à variável de volume do bot,
sinusbot_<instance>_volume, para baixar a música enquanto você fala. - Um widget Reprodutor de música para cada bot, ao lado de botões cuja cor acompanha a capa pela variável
music_player_<player>_album_color.
Vários bots e como funciona
Cada instância do SinusBot que você quer controlar é uma configuração. Dá para adicionar quantas quiser, inclusive instâncias em servidores diferentes, e escolher a instância no campo Player de cada ação. Quando você deixa Player vazio, a ação controla a primeira. Cada configuração recebe o próprio conjunto de variáveis, com o nome da configuração, como sinusbot_<instance>_volume.
O Macro Deck testa a conexão quando você cria uma configuração e carrega as instâncias que o bot tem. Enquanto roda, ele lê o estado da reprodução regularmente. Quando o bot fica inacessível por um instante, o deck continua mostrando a última faixa; quando continua inacessível, a variável sinusbot_<instance>_is_connected fica false e as ações não fazem nada até o bot responder de novo.
O que é necessário
- Um SinusBot em execução cuja interface web o Macro Deck consiga alcançar, por exemplo
http://your-bot:8087. - Um nome de usuário e uma senha do SinusBot.
- Pelo menos uma instância criada na interface web do SinusBot.
Configuração
Passo 1: Confira a interface web do SinusBot
Abra a interface web do SinusBot em um navegador e faça login. Anote o endereço com a porta, por exemplo
http://192.168.1.20:8087, e confirme que existe pelo menos uma instância.Passo 2: Abra a integração SinusBot
No Macro Deck, clique em Integrações na barra lateral e depois em SinusBot. Na aba Visão geral, clique em Adicionar configuração na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída.
Passo 3: Informe o servidor e o login
Na caixa de diálogo Conectar ao SinusBot, informe:
- URL do servidor: o endereço da interface web do SinusBot, com a porta.
- Nome de usuário e Senha: a conta usada para entrar no SinusBot.
Quando você clica em Continuar, o Macro Deck testa a conexão e carrega as instâncias.
Passo 4: Selecione a instância
Em Selecionar instância, escolha a instância do bot em Instância e clique em Continuar. A configuração é salva como SinusBot com o nome da instância entre parênteses. Repita esses passos para cada outra instância que quiser controlar.
Passo 5: Adicione uma ação a um botão
Na página Deck, clique em um botão. O deck precisa estar desbloqueado: se o botão Bloquear aparece no canto superior direito, ele está. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione SinusBot à esquerda da caixa de diálogo Adicionar ação, escolha Toggle Play/Pause e selecione a instância em Player.
Passo 6: Pressione o botão
Pressione o botão no seu deck. O bot inicia ou pausa a reprodução, e o botão mostra o estado atual. Um widget Reprodutor de música definido para a instância mostra a faixa que está tocando.
Ações13
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Play
- Retoma a reprodução.
- Pause
- Pausa a reprodução.
- Toggle Play/Pause
- Alterna entre reproduzir e pausar e mostra o estado atual no botão.
- Next Track
- Pula para a próxima faixa.
- Previous Track
- Volta para a faixa anterior.
- Refresh State
- Lê de novo, na hora, o estado do que está tocando.
- Set Volume
- Define o volume da reprodução (de 0 a 100%).
- Volume Up
- Aumenta o volume da reprodução em 10%.
- Volume Down
- Diminui o volume da reprodução em 10%.
- Seek
- Vai para uma posição da faixa atual, em segundos.
- Toggle Shuffle
- Alterna, ativa ou desativa a reprodução aleatória.
- Set Repeat Mode
- Ativa ou desativa a repetição. O SinusBot tem um único modo de repetição, então as duas opções de repetição o ativam.
- Play Track
- Toca uma faixa da biblioteca do bot. Deixe vazio para escolher uma faixa ao pressionar o botão.
Gatilhos7
Um botão ou fluxo pode reagir a estes eventos.
- Faixa alterada
- Outra faixa começou a tocar (em Reprodutor de música).
- Reprodução iniciada
- A reprodução começou ou foi retomada (em Reprodutor de música).
- Reprodução pausada
- A reprodução foi pausada (em Reprodutor de música).
- Reprodução parada
- A reprodução parou (em Reprodutor de música).
- Volume alterado
- O volume do bot mudou, com o valor novo e o anterior (em Reprodutor de música).
- Reprodutor conectado
- A instância do bot ficou acessível (em Reprodutor de música).
- Reprodutor desconectado
- A instância do bot não está mais acessível (em Reprodutor de música).
Variáveis8
Mostre estes valores em botões e widgets ou use-os em condições.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- A faixa atual e o artista dela. O SinusBot não informa um álbum, então
sinusbot_<instance>_current_albumfica vazia. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Se o bot está tocando, pausado ou parado.
sinusbot_<instance>_volume- O volume da reprodução em porcentagem. Também é possível defini-lo, por exemplo com um controle deslizante.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- A duração da faixa e a posição em segundos, e o progresso em porcentagem. Definir a posição salta para esse ponto.
sinusbot_<instance>_album_art_url- O endereço da capa atual.
sinusbot_<instance>_device_name- O nome da instância do bot.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Se a reprodução aleatória e a repetição estão ativadas.
sinusbot_<instance>_is_connected- Se o Macro Deck consegue alcançar a instância do bot.
Perguntas frequentes
Posso controlar mais de um bot?
Sim. Adicione uma configuração por instância do SinusBot, inclusive em servidores diferentes. Cada ação tem um campo Player para a instância que controla, e cada configuração tem variáveis próprias.
O SinusBot precisa rodar no mesmo computador?
Não. O Macro Deck se comunica com a interface web do SinusBot pela rede, então o bot pode rodar em um servidor ou em outro computador, desde que o Macro Deck consiga alcançar o endereço.
A configuração diz que nenhuma instância foi encontrada. O que fazer?
A conta não tem nenhuma instância que possa usar. Crie antes uma instância na interface web do SinusBot e depois configure de novo.
O que acontece quando o bot fica offline?
Uma interrupção curta não limpa o deck: ele mantém a última faixa por um instante. Quando o bot continua inacessível, a variável sinusbot_<instance>_is_connected fica false, e o Macro Deck continua tentando alcançá-lo.
Onde minha senha fica armazenada?
A senha fica armazenada criptografada no seu computador e só é usada para fazer login no seu SinusBot.
Mais em Chat e voz
Discord
Incluída no Macro DeckSilencie, ensurdeça, entre em canais de voz, ajuste as configurações de voz e publique mensagens por webhook no Discord pelo seu deck.
Webhooks do Discord
Incluída no Macro DeckPublique mensagens ricas com embeds e menções em canais do Discord por webhooks, com uma prévia ao vivo.