Entrar em plataformas

O que são estas páginas

Conexões → Canais é a lista de plataformas de streaming das quais o aplicativo lê: Twitch, YouTube e Kick, uma linha para cada uma. Conexões → Bots guarda essas mesmas três plataformas em um segundo papel: a conta com a qual o aplicativo escreve no chat, no lugar da sua.

Como configurar

1. Abra Conexões → Canais. A lista tem o cabeçalho Plataformas e canais ativos, e uma plataforma que você nunca conectou mostra o nome dela com Desconectado embaixo.
2. Pressione o botão daquela linha. Nele está escrito Conectar seguido do nome da plataforma. O conector inicia e a página de configurações dele abre na mesma hora.
3. Faça login por lá. As três páginas são diferentes e cada uma tem seu guia: "Integração com Twitch", "Integração com YouTube", "Integração com Kick". O que elas têm em comum é que o login é um botão, não um campo: nenhuma das três tem onde colar um token ou uma chave de acesso, então um conselho que começa com "cole o seu token" fala de outro programa.
4. Saia da página pela seta Voltar no canto superior esquerdo. Agora a linha mostra o nome da conta conectada e uma etiqueta.
5. A etiqueta diz CONECTADO, CONECTANDO..., LOGIN NECESSÁRIO ou ERRO, e muda sozinha enquanto você olha a lista. Atualizar, no canto superior direito, relê tudo.
6. Ao lado da etiqueta ficam Configurar, que abre a página da plataforma de novo, Desconectar, e um ícone de lixeira cuja dica diz Remover conexão.
7. Quando a etiqueta diz LOGIN NECESSÁRIO, o primeiro botão vira Reconectar e fica destacado. Ele abre a mesma página da plataforma, onde você faz login de novo. Nada mais conserta isso — não existe botão que renove o acesso por fora.

A conta do bot

Conexões → Bots tem o cabeçalho Bots de chat e lista essas mesmas três plataformas, porque todas as três conseguem escrever com uma segunda conta. A conexão é feita do mesmo jeito, com uma diferença que importa: faça login com a conta com a qual o bot deve falar, e não com a sua. É esse nome que os espectadores veem em cada resposta que o aplicativo envia.

A linha de um bot tem dois botões, Configurar e Desconectar bot, e nenhuma lixeira. O bot faz parte da conexão da plataforma, em vez de ser uma conexão própria.

Twitch: permissões concedidas

As permissões são entregues uma única vez, no login. Uma conta que fez login antes de um recurso existir não tem permissão para ele, e aí esse recurso simplesmente não faz nada, em silêncio, em vez de avisar do erro. A página do Twitch lista Permissões concedidas com um certo ou um xis para cada recurso e oferece Reautorizar, que é a única maneira de acrescentar a que falta; o guia "Integração com Twitch" percorre a lista.

Kick: endereço do canal e ID da sala de chat

• O endereço do canal não é o nome da conta. O Kick passa tudo para minúsculas e troca os sublinhados por hifens: uma conta chamada Some_Name fica some-name no endereço. Use o que está na barra de endereços do navegador. Ele vai em Nome do Canal Kick (Nome de usuário), e esse campo fica dentro da seção recolhida Avançado (manual) da página do Kick; em nenhum outro lugar dessa página ele entra.
• A proteção do Kick às vezes recusa a busca, e aí o aplicativo não consegue achar a sala de chat sozinho. O campo ID da Sala de Chat (Resolvido automaticamente) fica na mesma seção Avançado (manual) e é preenchido à mão. Esse é o caminho previsto para contornar isso, não uma gambiarra; o guia "Integração com Kick" percorre os campos.

YouTube: o chat chega junto com a transmissão

O módulo lê o chat ao vivo de uma transmissão que está no ar. Sem nada no ar não há nada para ler, então entre as lives CONECTADO com o chat vazio é o estado normal: quer dizer que o login funciona e o aplicativo está esperando a sua próxima live.

Durante uma live a etiqueta do YouTube acompanha o próprio chat, não só o login:

• CONECTANDO...: o aplicativo encontrou a sua transmissão e pediu o chat dela ao YouTube, e o YouTube ainda não respondeu.
• CONECTADO: o YouTube respondeu ao pedido do chat, e o chat está sendo lido.
• ERRO: a transmissão foi encontrada, mas não foi possível iniciar o chat dela. O aplicativo tenta de novo sozinho uma vez por minuto, e a etiqueta fica vermelha até o chat responder ou a live acabar.

Quando a live acaba, a etiqueta volta para CONECTADO. Um ERRO que sobrou de uma tentativa que falhou sem live no ar, por exemplo quando o aplicativo abriu antes de a internet voltar, também some sozinho alguns minutos depois que a conexão volta. Status da Conexão na página do YouTube informa o login, não o chat, e continua mostrando o seu canal como conectado enquanto o chat está fora. Então, durante uma live, avalie o chat pela etiqueta nesta lista ou pelo ponto do YouTube no painel de conexões no pé da barra lateral.

O canal e o bot fazem login em lugares diferentes, e nos dois casos continua sendo um botão: o canal abre o seu navegador de sempre, o bot abre uma janela dentro do aplicativo, e é nessa janela que você escolhe com qual canal ele escreve. O guia "Integração com YouTube" cobre os dois.

Desconectar e Remover conexão são coisas diferentes

Desconectar para o conector e mantém tudo o que ele guardou, inclusive o login. A linha volta a ter um botão Conectar, e pressioná-lo liga a plataforma de novo, normalmente sem um novo login. Enquanto está desligada, a plataforma inteira está desligada, bot incluído.

Remover conexão pergunta antes — uma caixa de diálogo com o título Confirmar Exclusão — e depois apaga tudo o que aquela plataforma guardou: o login do canal e o do bot, se algum tiver sido configurado. A caixa diz isso com todas as letras, porque o bot faz parte da mesma conexão e não pode ficar para trás. Depois disso, fazer login de novo é o único caminho de volta.

Como você percebe que alguma coisa caiu

O aplicativo não interrompe você. O que muda é o painel de conexões no pé da barra lateral: o cabeçalho dele conta as linhas que lista — Conectado (4/4), ou Parcialmente Conectado (3/4) quando uma delas não vai bem. Abra o painel e as linhas aparecem agrupadas em Canais, Bots, Doações, OBS e Servidor strAImer, cada uma com um ponto. Verde quer dizer conectado. Vermelho quer dizer que a plataforma informou um erro, ou que o aplicativo está sem internet nenhuma. Amarelo é todo o resto: conectando, login necessário, conexão caída e nenhuma notícia. É essa última parte que engana: uma plataforma que caiu não fica vermelha, fica amarela, a mesma cor de uma que ainda está subindo. Um amarelo que continua amarelo vale a pena abrir. Clicar na linha de uma plataforma abre a seção à qual ela pertence.

O que não pode fazer

• Nenhuma plataforma além de Twitch, YouTube e Kick. VK Play, Trovo e Rumble não têm módulo — nem no aplicativo, nem no Catálogo de Módulos — e nada nessa página acrescenta um.
• Os serviços de doação não ficam aqui. DonationAlerts, DonatePay e os demais vivem em Conexões → Monetização, e a maioria deles é conectada colando um token, e não fazendo login, por isso a regra acima sobre tokens vale só para os canais. O guia para eles é "Monetização". O OBS tem a própria seção, Conexões → OBS, e o próprio guia, "OBS".
• Uma conta por plataforma em cada papel. Uma linha comporta um canal e um bot; não dá para ler dois canais da Twitch ao mesmo tempo.
• Não há aviso quando o acesso expira. Nada aparece na tela, nada toca e nada é escrito por cima da sua transmissão. A etiqueta e o contador da barra lateral mudam, e uma linha vermelha cai na Console de registros no pé da janela, mas nada disso vai se fazer ouvir no meio da transmissão.
• Aqui não se vê chat, espectadores nem eventos. Estas linhas conectam a plataforma e informam o estado dela; o que chega dela é mostrado pelos widgets e pelo painel de controle.
• Remover uma conexão não pode ser desfeito por aqui. Não há restauração nem histórico de conexões: só fazer login de novo.