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.
Um widget Chat da Twitch e widgets Estatísticas da transmissão na Twitch com espectadores, participantes do chat e seguidores
- Widgets Chat da Twitch e Estatísticas da transmissão na Twitch
- Defina título e categoria, exiba anúncios, inicie raids e crie clipes
- Enquetes, previsões, shoutouts e modos do chat a partir de um botão
- Gatilhos para follows, subs, bits, raids e resgates
- Conecte várias contas da Twitch
A integração Twitch conecta uma ou mais contas da Twitch ao Macro Deck. O login é feito na Twitch com um código curto, e o Macro Deck passa a receber os eventos do seu canal no momento em que acontecem e pode agir no canal como essa conta.
O que dá para fazer
- Mude o título, a categoria e as tags da transmissão, envie mensagens e anúncios no chat e dê shoutouts.
- Exiba um intervalo de anúncios, adie o próximo, inicie ou cancele uma raid, crie um clipe ou um marcador de transmissão.
- Inicie e encerre enquetes e previsões, e marque resgates de pontos do canal como concluídos ou reembolsados.
- Modere: bana ou suspenda temporariamente um usuário, desbana, exclua uma mensagem, limpe o chat e ative ou desative os modos somente emotes, somente seguidores, lento, somente inscritos ou mensagens únicas.
- Mostre o chat com emotes e emblemas no widget Chat da Twitch e modere a partir dele.
- Mostre o status ao vivo, espectadores, participantes do chat, seguidores e inscritos, título, categoria e tempo no ar no widget Estatísticas da transmissão na Twitch.
Alguns exemplos de uso:
- Um botão Começando em breve que define o título e a categoria e envia um anúncio no chat.
- Um botão Intervalo que exibe um comercial de 90 segundos.
- Um botão Clipe que cria um clipe e grava a URL de edição dele em uma variável.
- Um fluxo executado em Recompensa de pontos do canal resgatada para uma recompensa que troca a cena do OBS.
- Um fluxo executado em Raid recebida que dá um shoutout para quem fez a raid.
Como funciona
O Macro Deck assina os eventos da Twitch para cada conta conectada, então gatilhos como Novo seguidor, Bits enviados ou Raid recebida disparam em instantes. Valores da transmissão, como o número de espectadores, são lidos da Twitch a cada 30 segundos. Todos os valores estão disponíveis como variáveis com nomes twitch_<account>_<value>, por exemplo twitch_mychannel_viewer_count, para usar nos seus próprios widgets e condições.
É possível conectar mais de uma conta da Twitch. Toda ação tem um campo Conta, e todo gatilho pode ser limitado a uma conta. Se a Twitch não conceder todas as permissões que o Macro Deck pede, Integrações lista os eventos que não vão disparar e oferece reconectar. Quando a conexão com a Twitch cai, o Macro Deck se reconecta sozinho. Se o Macro Deck não for usado com uma conta por 30 dias, ou se o acesso dele for revogado na Twitch, o login expira e Integrações pede para conectar a conta de novo.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux, com acesso à internet
- Uma conta da Twitch
- Exibir anúncio exige um canal afiliado ou parceiro que esteja ao vivo
- Clipes e marcadores de transmissão só funcionam com o canal ao vivo
Configuração
Passo 1: Abra a Twitch no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em Twitch. 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 2: Aprove o acesso na Twitch
A caixa de diálogo Conectar uma conta da Twitch mostra um Código do dispositivo. Clique em Abrir a Twitch e aprovar: a Twitch abre no navegador com o código já preenchido. Faça login com a conta que quer conectar e aprove o acesso.
Para usar uma aplicação da Twitch registrada por você, ative Configuração avançada e informe o Client ID dela em Client ID próprio (avançado). Deixe o campo vazio para usar a aplicação do próprio Macro Deck.
Passo 3: Conclua a configuração
Volte ao Macro Deck e clique em Continuar. O Macro Deck dá à configuração o nome da sua conta, por exemplo Twitch (mychannel). Quando a caixa de diálogo mostrar Configuração concluída., clique em Concluído.
Passo 4: Adicione uma ação da Twitch 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 Twitch à esquerda da caixa de diálogo Adicionar ação e escolha uma ação como Enviar mensagem no chat. Escolha a Conta, digite a Mensagem e clique em Salvar.
Passo 5: Pressione o botão
Pressione o botão no celular, no tablet ou no cliente web. A mensagem aparece no seu chat da Twitch. Para ver o chat no deck, adicione um widget Chat da Twitch.
Ações20
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Definir título e categoria
- Muda o título, a categoria ou as tags da transmissão. Campos deixados vazios não são alterados.
- Enviar mensagem no chat
- Envia uma mensagem ao chat do canal como a conta conectada, opcionalmente como resposta.
- Enviar anúncio
- Publica um anúncio destacado no chat, na cor escolhida.
- Enviar shoutout
- Dá um shoutout para outro canal. A Twitch permite um a cada dois minutos.
- Limpar chat
- Remove todas as mensagens do chat do canal.
- Excluir mensagem do chat
- Remove uma única mensagem do chat.
- Definir modo do chat
- Ativa, desativa ou alterna os modos somente emotes, somente seguidores, lento, somente inscritos ou mensagens únicas.
- Exibir anúncio
- Inicia um intervalo de anúncios de 30 segundos a 3 minutos.
- Adiar próximo anúncio
- Adia em cinco minutos o próximo intervalo de anúncios agendado.
- Iniciar raid
- Envia os espectadores do canal para outro canal.
- Cancelar raid
- Interrompe uma raid que ainda não foi concluída.
- Criar clipe
- Faz um clipe dos últimos 30 segundos da transmissão e pode gravar a URL de edição do clipe em uma variável.
- Criar marcador de transmissão
- Marca o ponto atual da transmissão para edição posterior.
- Banir ou suspender usuário
- Bane um espectador, ou o suspende temporariamente quando uma duração é informada.
- Desbanir usuário
- Remove um banimento ou uma suspensão temporária.
- Criar enquete
- Inicia uma enquete com duas a cinco opções.
- Encerrar enquete
- Encerra a enquete em andamento.
- Criar previsão
- Inicia uma previsão com pontos do canal, com dois a dez resultados.
- Encerrar previsão
- Resolve, bloqueia ou cancela a previsão em andamento.
- Resolver resgate de recompensa
- Marca um resgate de pontos do canal como concluído ou o reembolsa (só para recompensas criadas pela mesma aplicação da Twitch).
Gatilhos39
Um botão ou fluxo pode reagir a estes eventos.
- Transmissão online
- O canal entrou ao vivo.
- Transmissão offline
- O canal parou de transmitir.
- Informações do canal atualizadas
- O título, a categoria, o idioma ou os rótulos de conteúdo mudaram.
- Intervalo de anúncios iniciado
- Um intervalo de anúncios começou no canal.
- Novo seguidor
- Alguém seguiu o canal.
- Nova inscrição
- Alguém se inscreveu no canal. Opcionalmente só para um nível.
- Renovação de inscrição
- Alguém anunciou uma renovação de inscrição no chat.
- Inscrições presenteadas
- Alguém presenteou inscrições no canal.
- Inscrição encerrada
- Uma inscrição no canal expirou.
- Bits enviados
- Alguém enviou bits no canal.
- Raid recebida
- Outro canal fez uma raid neste.
- Raid enviada
- Este canal fez uma raid em outro.
- Shoutout recebido
- Outro canal deu um shoutout para este.
- Shoutout enviado
- O canal enviou um shoutout.
- Recompensa de pontos do canal resgatada
- Um espectador resgatou uma recompensa de pontos do canal. Opcionalmente só para uma recompensa.
- Recompensa automática resgatada
- Um espectador usou uma das recompensas de pontos do canal que já vêm com a Twitch.
- Resgate resolvido
- Um resgate de pontos do canal foi aceito ou reembolsado.
- Enquete iniciada
- Uma enquete começou no canal.
- Enquete encerrada
- Uma enquete do canal terminou.
- Previsão iniciada
- Uma previsão começou no canal.
- Previsão bloqueada
- Uma previsão parou de aceitar participações.
- Previsão encerrada
- Uma previsão foi resolvida ou cancelada.
- Hype Train iniciado
- Um Hype Train começou no canal.
- Progresso do Hype Train
- Um Hype Train do canal avançou.
- Hype Train encerrado
- Um Hype Train do canal terminou.
- Meta iniciada
- Uma meta de criador começou.
- Progresso da meta
- Uma meta de criador avançou.
- Meta encerrada
- Uma meta de criador terminou.
- Notificação do chat
- Um aviso de sub, resub, presente, raid, anúncio ou caridade no chat. Opcionalmente só para um tipo.
- Chat limpo
- O chat do canal foi limpo.
- Mensagem do chat excluída
- Uma única mensagem do chat foi excluída.
- Modo do chat alterado
- O modo somente emotes, somente seguidores, lento, somente inscritos ou mensagens únicas foi alterado.
- Usuário banido ou com suspensão temporária
- Um espectador foi banido ou suspenso temporariamente.
- Usuário desbanido
- Um espectador foi desbanido.
- VIP adicionado
- Um espectador recebeu o status de VIP.
- VIP removido
- Um espectador perdeu o status de VIP.
- Evento da Twitch (avançado)
- Todos os eventos da Twitch, incluindo os que o Macro Deck ainda não modela, com o payload bruto.
- Conectado
- O Macro Deck conectou a conta à Twitch.
- Desconectado
- A conexão com a Twitch foi perdida.
Variáveis10
Mostre estes valores em botões e widgets ou use-os em condições.
twitch_<account>_is_connected- Se a conta está conectada à Twitch.
twitch_<account>_is_live- Se o canal está ao vivo.
twitch_<account>_stream_title,twitch_<account>_stream_category- O título e a categoria atuais.
twitch_<account>_viewer_count,twitch_<account>_uptime_seconds- Os espectadores e há quantos segundos a transmissão está rodando.
twitch_<account>_follower_count,twitch_<account>_subscriber_count,twitch_<account>_subscriber_points- Totais do canal de seguidores, inscritos e pontos de inscrito.
twitch_<account>_chatter_count- Todas as pessoas no seu chat, incluindo você e bots.
twitch_<account>_stream_thumbnail_url- A URL da miniatura atual da transmissão.
twitch_<account>_display_name,twitch_<account>_login- O nome de exibição e o nome de login da conta.
twitch_<account>_emote_only,twitch_<account>_followers_only,twitch_<account>_followers_only_duration,twitch_<account>_slow_mode,twitch_<account>_slow_mode_wait_time,twitch_<account>_subscriber_only,twitch_<account>_unique_chat- Os modos do chat: somente emotes, somente seguidores e a duração dele em minutos, modo lento e o tempo de espera dele em segundos, somente inscritos e mensagens únicas.
twitch_<account>_last_follower,twitch_<account>_last_subscriber,twitch_<account>_last_cheerer,twitch_<account>_last_raider- O seguidor, o inscrito, quem enviou bits e quem fez raid mais recentes.
Widgets2
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Chat da Twitch
- Mostra o chat do seu canal com emotes e emblemas. Pressione para abrir um chat maior em que é possível excluir mensagens, suspender temporariamente e banir.
- Estatísticas da transmissão na Twitch
- Mostra o status ao vivo, espectadores, participantes do chat, seguidores e inscritos, título, categoria e tempo no ar, no estilo escolhido.
Perguntas frequentes
Posso conectar mais de uma conta da Twitch?
Sim. Clique de novo em Adicionar configuração e aprove com a outra conta. Cada ação tem um campo Conta, e as variáveis levam o nome da conta, por exemplo twitch_mychannel_is_live.
Por que preciso fazer login de novo?
A Twitch encerra o login após 30 dias sem uso, ou quando o acesso do Macro Deck é revogado na Twitch. Integrações mostra então que o login expirou. Use Reconectar para aprovar o acesso de novo.
Por que uma ação falha?
Muitas ações só funcionam em certas situações: Criar clipe e Criar marcador de transmissão precisam do canal ao vivo, Exibir anúncio precisa de um canal afiliado ou parceiro que esteja ao vivo, e Enviar shoutout funciona uma vez a cada dois minutos. Se a Twitch não concedeu uma permissão, conecte a conta de novo para concedê-la.
Por que não consigo resolver resgates das minhas recompensas existentes?
A Twitch só permite que uma aplicação resolva resgates de recompensas criadas pela mesma aplicação. Recompensas criadas no painel da Twitch não podem ser resolvidas pela API.
Quem pode moderar pelo widget de chat?
Qualquer pessoa que possa usar o seu deck. Para só mostrar o chat, desative Permitir moderação na janela do chat nas configurações do widget.
Onde ficam armazenados os tokens da Twitch?
O Macro Deck armazena os tokens de acesso e de atualização criptografados no computador em que o Macro Deck está rodando. Você nunca digita a sua senha da Twitch no Macro Deck: o acesso é aprovado na própria Twitch.
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.
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.
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.