Integração com Twitch

Vem com o strAImer: este módulo é instalado junto com o aplicativo, então não há nada para baixar. Ele aparece em Catálogo de Módulos → Integrados.

O que é esta página

A página conecta uma conta da Twitch ao aplicativo — como sua descrição diz, "Configure a integração com o Twitch para receber mensagens do chat, recompensas e gerenciar seu canal." Ela existe em duas variantes: o próprio canal do streamer e uma conta separada da qual o bot escreve.

Contar Bits como doações fica na aba do canal. Os cheers também chegam como doação, então os Bits movem metas de arrecadação, lances do leilão e totais da transmissão — pela taxa de «Configurações → Taxas de Câmbio». Desative para manter os Bits separados do dinheiro; o contador de Bits continua de qualquer forma. É o que faz um cheer mover uma meta de arrecadação ou dar um lance no leilão; desligado, os Bits continuam sendo um contador à parte. De fábrica um bit vale um centavo de dólar, o que a Twitch paga por bit, convertido para a sua moeda base; uma taxa sua em «Configurações → Taxas de Câmbio» substitui esse valor.

Mexer nessa chave reinicia a conexão com a Twitch: o chat e o fluxo de eventos se reconectam, o que leva alguns segundos, e mensagens do chat ou eventos desses segundos podem se perder. Ajuste antes de entrar ao vivo, e não no meio da transmissão.

Como configurar

1. Abra Conexões → Canais e abra a página da Twitch. Seu cabeçalho diz Conta do Streamer (Lê eventos, EventSub).
2. Status da Conexão mostra uma de cinco frases. A dica ao lado nomeia o que está sendo solicitado: "Requer permissões máximas (ler chat, gerenciar transmissão, enquetes, previsões e pontos do canal)."
3. Pressione Autorizar via Navegador. A página tem um botão e nenhum campo para um token: o login abre no seu navegador usual e termina lá.
4. O navegador vai direto para a página de confirmação da própria Twitch, com o código já preenchido. Entre na Twitch lá se ela pedir, confirme o código e permita o acesso. O resultado é mostrado pela própria Twitch, não por uma página do strAImer, então no final não aparece nenhuma página dizendo "Autorização bem-sucedida!". Depois você pode fechar a aba do navegador.
5. Enquanto você está no navegador, a página do módulo diz "Conclua o login na janela do navegador — esta página vai atualizar sozinha." Depois de dois minutos ela muda para "Ainda esperando o navegador. Conclua o login por lá — esta página vai atualizar sozinha. Se demorar um pouco, nada se perde." Não pressione o botão de novo enquanto esse login estiver aberto: um novo clique inicia um login novo, e o que está no navegador deixa de valer. Depois de trinta minutos a página desiste: "O login não foi concluído. A janela do navegador foi fechada ou o acesso foi negado — aperte o botão para tentar de novo." Se você recusar o acesso na Twitch, a página não fica sabendo: ela espera até esse limite do mesmo jeito.
6. Quando o login é concluído, a página do módulo relata Configuração do Twitch salva com sucesso! e se fecha um momento depois. Nome da Conta (login) agora mostra o login conectado; o campo é somente leitura.
7. Permissões concedidas aparece: "Quais recursos funcionam com o token atual". Cada recurso está marcado ou riscado, doze linhas na aba do canal: Ler e enviar mensagens no chat, Eventos de novos seguidores, Eventos de assinatura paga, Eventos de bits, Recompensas de pontos do canal, Eventos de Hype Train, Eventos de metas do canal, Enquetes, Previsões, Alterar título e categoria da transmissão, Criar clipes, Moderação: banir e excluir mensagens.
8. Se algo estiver riscado, um aviso é exibido: "Algumas permissões estão faltando — os recursos relacionados não funcionarão. Reautorize para concedê-las." O botão Reautorizar ao lado inicia o mesmo login no navegador, e é isso que adiciona os direitos faltantes.
9. A seta no canto superior esquerdo, Voltar, sai da página.

O que as cinco frases de status significam

• Conectado como {username} — verde. A conta está salva e nem a Twitch nem o módulo a recusaram. É isso que certifica: o login está bom. Não é um teste ao vivo de se os eventos estão fluindo neste segundo.
• Conectando... — amarelo, com o nome da conta ainda à mostra. O módulo está levantando a conexão: logo depois que o aplicativo inicia, e sempre que uma das duas metades dela, o chat ou o fluxo de eventos, cai. As duas voltam sozinhas, então esta frase costuma ficar verde em segundos.
• Entre novamente para reconectar — amarelo. A conta ainda está aqui e seu nome ainda é mostrado abaixo, porque você precisa saber qual conta reparar, mas a Twitch recusou o acesso salvo e não o renovará em segundo plano. Nada chega do canal até você entrar novamente, e entrar novamente é o único reparo; não há botão que o atualize de fora.
• Erro de conexão — vermelho. A conta está boa e a conexão não está: o fluxo de eventos caiu, ou o módulo não conseguiu finalizar sua configuração. O módulo tenta novamente sozinho, então este muitas vezes se resolve sem você tocar em nada.
• Desconectado — vermelho, e o único dos cinco que oculta a linha Nome da Conta (login), porque não há conta salva nesta página ainda. É isso que uma instalação nova mostra.

O selo se atualiza em tempo real: ele muda com a página aberta, então não é preciso sair e voltar para ver uma frase nova.

A conta do bot

A mesma página em Conexões → Bots é intitulada Conta do Bot (Envia respostas no chat), e sua dica é mais curta: "Requer permissões para ler e enviar mensagens no chat." O login é o mesmo botão, Autorizar via Navegador: entre lá sob a conta da qual o bot deve escrever, não a sua própria. Sua lista Permissões concedidas tem uma linha só, Ler e enviar mensagens no chat, porque o bot só escreve no chat. Banimentos e exclusão de mensagens passam pela conta do streamer, e é por isso que Moderação: banir e excluir mensagens fica na aba do canal.

As duas contas são julgadas separadamente, e o bot nunca diz Erro de conexão. Um login do bot que a Twitch recusou não arrasta a própria conexão do streamer para Entre novamente para reconectar junto.

Se o navegador relatar um erro

Em vez da página da Twitch, o navegador pode mostrar Erro de Autorização com "Falha ao trocar o código de autorização por tokens: {error}". Isso significa que o login nem conseguiu começar, na maioria das vezes porque não foi possível alcançar a Twitch. A conta permanece como estava; pressione Autorizar via Navegador novamente.

O que não pode fazer

• Não há lugar para colar um token, uma chave de acesso ou uma chave de atualização. Autorizar via Navegador é a única entrada, e também é como um login expirado é renovado.
• Nome da Conta (login) não pode ser digitado. Para conectar uma conta diferente, entre como essa conta.
• As permissões não podem ser escolhidas uma a uma. A lista de marcações apenas relata o que o login atual carrega; Reautorizar entrega todo o conjunto novamente.
• Não há campos de Client ID e Client Secret, e nenhum é necessário: o login passa pelo próprio aplicativo strAImer.
• A página não tem botão Salvar: tudo é armazenado ao final do login no navegador. A chave Contar Bits como doações é salva no momento em que você a aciona.
• A página não desconecta a conta nem exclui a conexão, e não desliga o módulo.
• A conta do streamer e a conta do bot são configuradas separadamente: um login não preenche o outro.