Streamer.bot
Incluída no Macro DeckExecute ações do Streamer.bot, envie mensagens no chat e reaja a todos os eventos que o Streamer.bot informa.
A caixa de diálogo Conectar Streamer.bot com endereço, porta, endpoint e senha
- Execute qualquer ação do Streamer.bot, com argumentos
- Dispare gatilhos de código personalizados
- Envie mensagens no chat da Twitch, YouTube, Trovo ou Kick
- Reaja a qualquer evento que o Streamer.bot informa
- Leia variáveis globais do Streamer.bot no Macro Deck
A integração Streamer.bot conecta o Macro Deck ao servidor WebSocket do Streamer.bot. Os botões iniciam as ações que você montou no Streamer.bot, e tudo o que o Streamer.bot informa (mensagens de chat, follows, subs, raids, resgates de pontos do canal, timers e eventos de código personalizados) pode iniciar um fluxo no Macro Deck.
O que dá para fazer
- Execute uma ação do Streamer.bot. Escolha-a na lista das suas ações e passe argumentos opcionais, que a ação lê como
%key%. - Dispare um gatilho de código personalizado, também com argumentos opcionais.
- Envie uma mensagem no chat pelo Streamer.bot para Twitch, YouTube, Trovo ou Kick, como a conta do streamer ou como a conta do bot. A mensagem pode conter variáveis do Macro Deck e valores de eventos.
- Leia uma variável global do Streamer.bot, persistida ou só da sessão, para uma variável do Macro Deck.
- Reaja a qualquer evento do Streamer.bot com o gatilho Evento do Streamer.bot. Escolha uma origem, por exemplo Twitch, e um evento para filtrar, ou deixe os dois vazios para reagir a tudo. O fluxo recebe o usuário, a mensagem e os dados brutos do evento em JSON.
Alguns exemplos de uso:
- Um botão Cena: Jogos que executa uma ação do Streamer.bot e passa o nome da cena como argumento.
- Um botão Beber água com duas ações Enviar mensagem no chat que publicam o mesmo lembrete na Twitch e no YouTube.
- Um fluxo executado em um evento de follow da Twitch no Streamer.bot que mostra uma notificação no Macro Deck.
- Um botão que lê um contador de uma variável global do Streamer.bot e o mostra como rótulo.
Como funciona
O Macro Deck fica conectado ao Streamer.bot e recebe os eventos dele no momento em que acontecem. As variáveis mostram se a conexão está ativa, a versão do Streamer.bot, o nome da instância e o nome e a plataforma do streamer. Quando o Streamer.bot é fechado ou o servidor WebSocket dele para, o Macro Deck continua tentando reconectar, e os gatilhos Conectado e Desconectado permitem que um fluxo reaja. A integração tem uma única configuração.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux
- Streamer.bot rodando neste computador ou em outro da sua rede
- O servidor WebSocket iniciado no Streamer.bot em Servers/Clients > WebSocket Server
Configuração
Passo 1: Inicie o servidor WebSocket no Streamer.bot
No Streamer.bot, abra Servers/Clients > WebSocket Server e verifique se o servidor está iniciado. Anote o endereço, a porta e o endpoint, e a senha se a autenticação estiver ativada.
Passo 2: Abra o Streamer.bot no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em Streamer.bot. Na aba Visão geral, clique em Configurar 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 os dados de conexão
Preencha a caixa de diálogo Conectar Streamer.bot:
- Endereço:
127.0.0.1quando o Streamer.bot roda no mesmo computador, senão o endereço IP dele. - Porta: a porta do servidor WebSocket,
8080por padrão. - Endpoint: o caminho em que o servidor escuta,
/por padrão. - Senha: só se a autenticação estiver ativada no Streamer.bot.
Clique em Continuar. O Macro Deck testa a conexão antes de salvá-la.
- Endereço:
Passo 4: Adicione uma ação do Streamer.bot a um botão
Na página Deck, clique no botão que você quer usar. O deck precisa estar desbloqueado: se o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Streamer.bot à esquerda da caixa de diálogo Adicionar ação e escolha Executar ação. Selecione a ação do Streamer.bot em Ação e, se ela precisar, adicione Argumentos. Depois clique em Salvar.
Passo 5: Pressione o botão
Pressione o botão no celular, no tablet ou no cliente web. O Streamer.bot executa a ação. Se nada acontecer, confira se o servidor WebSocket do Streamer.bot está iniciado e se a configuração mostra Conectado na página do Streamer.bot em Integrações.
Ações4
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Executar ação
- Executa uma ação do Streamer.bot, com argumentos opcionais.
- Executar gatilho de código
- Dispara um gatilho de código personalizado do Streamer.bot, com argumentos opcionais.
- Enviar mensagem no chat
- Envia uma mensagem no chat pelo Streamer.bot para Twitch, YouTube, Trovo ou Kick.
- Obter variável global
- Lê uma variável global do Streamer.bot para uma variável do Macro Deck.
Gatilhos3
Um botão ou fluxo pode reagir a estes eventos.
- Evento do Streamer.bot
- Qualquer coisa que o Streamer.bot informa, como mensagens de chat, follows, subs, raids, resgates, timers e eventos de código personalizados. Opcionalmente filtrado por origem e evento.
- Conectado
- O Macro Deck se conectou ao Streamer.bot.
- Desconectado
- A conexão com o Streamer.bot foi perdida.
Variáveis5
Mostre estes valores em botões e widgets ou use-os em condições.
streamerbot_is_connected- Se o Macro Deck está conectado ao Streamer.bot.
streamerbot_version- A versão do Streamer.bot.
streamerbot_instance_name- O nome da instância do Streamer.bot.
streamerbot_broadcaster_name- A conta do streamer no Streamer.bot.
streamerbot_broadcaster_platform- A plataforma da conta do streamer.
Perguntas frequentes
Funciona quando o Streamer.bot roda em outro computador?
Sim. Informe o endereço IP desse computador como Endereço. No Streamer.bot, o servidor WebSocket precisa escutar em um endereço que o outro computador consiga alcançar, e a porta precisa estar aberta no firewall dele.
Preciso de uma senha?
Só se a autenticação do servidor WebSocket estiver ativada no Streamer.bot. O Macro Deck armazena a senha criptografada no computador em que o Macro Deck está rodando.
Como passo valores para uma ação do Streamer.bot?
Adicione-os em Argumentos em Executar ação ou Executar gatilho de código. Cada chave fica disponível no Streamer.bot como %key%.
O que acontece quando o Streamer.bot é fechado?
O Macro Deck continua tentando reconectar e se conecta de novo quando o servidor WebSocket volta. Até lá, as ações falham com O Streamer.bot não está conectado.
Por que Obter variável global diz que a variável não existe?
Confira o nome e se a variável está persistida no Streamer.bot. Desative Persistido na ação para ler uma variável que só existe na sessão atual.
Mais em Transmissão
OBS Studio
Incluída no Macro DeckTroque cenas, controle transmissão, gravação e áudio e reaja ao que acontece no OBS Studio.
Meld Studio
Incluída no Macro DeckTroque e prepare cenas, controle camadas, efeitos e faixas de áudio e entre ao vivo no Meld Studio.
Streamlabs Desktop
Incluída no Macro DeckTroque cenas e controle a transmissão, a gravação e as fontes de áudio no Streamlabs Desktop.
Twitch
Incluída no Macro DeckMostre o chat e as estatísticas da sua live na Twitch, modere, faça enquetes e anúncios e reaja a follows, subs e raids.
YouTube
Incluída no Macro DeckMostre o chat ao vivo e as estatísticas da sua transmissão no YouTube, mude título e tags e reaja a Super Chats e membros.