Twitch: chat, eventos e pontos do canal

O que chega da Twitch

Cada um destes vira um evento comum, e qualquer outro módulo pode reagir a ele — alertas, metas, o leilão, a voz sintetizada, as estatísticas.

• Mensagens do chat com emblemas, emotes e a cor de nick que o espectador escolheu.
• Seguidores, e assinaturas separadas nos casos que diferem: nova, renovada com a contagem de meses, e presenteada com o nome de quem deu. Nível 1/2/3 ou Prime.
• Bits, com a mensagem que o espectador escreveu junto e o cheermote que ele escolheu — não só o valor.
• Os bits também chegam como dinheiro: eles movem as barras de metas e entram no que foi arrecadado na transmissão. Um bit conta como um centavo de dólar, o que a Twitch paga por bit, convertido para a sua moeda base; defina uma taxa própria se você conta de outro jeito.
• Raids, com o canal de onde vieram e quantos espectadores chegaram junto.
• Resgates de pontos do canal, incluindo o texto que o espectador digitou na recompensa.
• Enquetes e previsões, do momento em que começam até o resultado, não importa se foram iniciadas aqui ou na própria Twitch.
• A contagem de espectadores enquanto o canal está ao vivo, e o título e a categoria sob os quais ele está no ar.

O que o aplicativo pode fazer na Twitch

A conexão não é só de leitura. O que ela pode fazer é exatamente o que você concedeu ao autorizar, e a página de configurações lista cada permissão ao lado da função a que ela pertence.

• Escrever no chat — com a sua própria conta, ou com uma conta de bot separada que você conecta de propósito.
• Criar uma recompensa de pontos do canal com custo, cor, descrição para os espectadores, tempo de recarga e limites por transmissão — ou copiar uma que já existe como ponto de partida.
• Ligar e desligar uma recompensa, ou excluí-la, sem abrir o painel da Twitch.
• Devolver os pontos de um resgate recusado: o leilão faz isso com um lance que ele não aceita, se você deixar essa chave ligada.
• Cortar um clipe a partir de um cenário, para que um momento que vale a pena guardar seja salvo enquanto ainda está acontecendo.
• Suspender, banir, remover o ban ou apagar uma mensagem pelo bloco do chat, sem sair do aplicativo.

Pontos do canal como gatilho

Esta é a parte que transforma um recurso da Twitch em todo o resto do aplicativo. Uma recompensa não é um fim em si mesma — é o botão que os seus espectadores pagam para apertar.

• Um resgate dispara um cenário: uma cena do OBS, uma fonte ou um filtro, um som, uma frase lida em voz alta, uma mensagem no chat, uma tomada inteligente.
• Um resgate sobe um lance no leilão — você escolhe quais recompensas participam e a partir de qual custo elas contam.
• A lista de recompensas fica sincronizada com a Twitch, então o que você vê no aplicativo é o que os espectadores veem no canal.
• As recompensas criadas aqui e as criadas no painel da Twitch aparecem separadas, porque só as primeiras podem ser gerenciadas pela API.
• Uma recompensa configurada para ignorar a fila de solicitações é marcada como concluída pela Twitch no instante em que é resgatada — e é por isso que os pontos dela não podem mais ser devolvidos.

O que isto não é

A Twitch é um serviço na internet, e isto é um programa no seu computador que conversa com ela. Daí saem algumas fronteiras que é melhor dizer sem rodeios.

• Não é um bot morando na nuvem: enquanto o aplicativo está fechado, não tem nada nosso sentado no seu chat.
• Não substitui a Twitch. Assinaturas, bits e pontos continuam sendo dela — o aplicativo lê tudo isso e age em cima.
• Como a própria transmissão, ele precisa de internet: a conexão é com a Twitch, e sem ela não há o que ler.
• Ele não mexe nas recompensas que não criou. A Twitch só deixa um aplicativo gerenciar as próprias, então as demais ficam visíveis e fora de alcance.
• Não é um serviço de moderação: os botões de moderação fazem o que a sua própria conta tem permissão de fazer no seu canal, e nada além.

O que acontece com o acesso

A autorização é a parte com a qual as pessoas têm razão em ter cuidado, então vale a pena ser preciso.

• Você autoriza na página da própria Twitch — o aplicativo nunca vê a sua senha.
• O token é criptografado com o cofre de chaves do seu sistema operacional e nunca sai do seu computador.
• Não é preciso registrar uma conta de desenvolvedor nem colar chaves em lugar nenhum: a autorização passa pelo próprio aplicativo strAImer.
• Cada permissão concedida fica ao lado da função que ela libera, então “isto aqui não faz nada” ganha uma resposta para você olhar em vez de um palpite.
• Os tokens são renovados antes de vencer e a conexão volta sozinha depois de uma queda de rede; e quando a Twitch recusa de vez, o aplicativo avisa em vez de ficar tentando em silêncio.
• Dá para conectar uma segunda conta para que o aplicativo escreva como bot e o seu nome não fique embaixo de toda mensagem automática. A leitura sempre passa pelo seu próprio canal — o bot só envia.

Onde tudo isso aparece

Fora a página em que você o conecta, a Twitch não ganha uma tela própria: o evento chega onde já é esperado, e não há nada para ligar entre os módulos na mão.

• O bloco Stream: Chat no painel de controle, que mostra todos os chats conectados em um feed só e envia pelo mesmo campo.
• O bloco Stream: Eventos, que mantém a lista corrida — quem seguiu, quem assinou, quem mandou bits, quem resgatou o quê.
• O bloco Stream: Espectadores, que mostra a contagem que a Twitch informa enquanto o canal está ao vivo.
• Os alertas, as barras de metas e o leilão, que pegam os mesmos eventos sem nada para conectar antes.
• Estatísticas da Transmissão, que guarda tudo depois que a transmissão acaba, para que os números não vão embora junto com a sessão.

Do que é feito

Cada parte é um módulo separado: você instala apenas os que precisa, e qualquer um pode ser removido sem afetar os restantes.

Começar

1. Abra Conexões → Canais, aperte conectar e confirme o acesso na página da Twitch.
2. Conecte uma segunda conta em Conexões → Bots se preferir que o aplicativo não escreva com o seu próprio nome.
3. Abra Automação → Recompensas do Canal e crie as recompensas que você quer que os espectadores comprem, ou aproveite as que já existem.
4. Ligue uma recompensa a um cenário em Automação → Cenários, ou marque-a como participante do leilão.
5. Se para você um bit tem outro valor que não um centavo de dólar, defina isso em Configurações → Taxas de Câmbio.

A Twitch permite 50 recompensas no total em um canal, não importa como foram criadas, e uma recompensa feita no painel da Twitch não pode ser alterada pela API de jeito nenhum — é regra da plataforma, não nossa. O aplicativo mostra em quais das suas recompensas ele pode mexer e em quais não.

Funciona em conjunto com