Configurações da Trula

Instalado à parte: este módulo não vem no instalador do aplicativo. Abra Catálogo de Módulos → Extensões e clique em Instalar no cartão dele; até lá, o aplicativo não tem esse módulo.

O que é esta página

Conexões → Monetização → Trula é onde a Trula recebe o token do seu painel dock do OBS para que as doações cheguem ao aplicativo. Duas coisas vivem aqui: o interruptor Aceitar doações e o próprio token.

Na Trula, uma doação e um pedido de música são a mesma ação: o espectador paga e a música entra na fila. O aplicativo recebe só a doação em si: o valor, o nome e a mensagem. A fila de músicas e o player ficam na Trula, então uma música pedida não é mostrada nem tocada pelo strAImer; use o próprio player da Trula para a música.

Como configurar

1. Abra Conexões → Monetização e pressione Conectar Trula no cartão. Em um cartão já conectado, a mesma página abre com Configurar. A seta no canto superior esquerdo, Voltar, regressa à lista.
2. A página tem o título Configurações da Trula, com "Configure a Trula para receber notificações de doações." por baixo.
3. A linha superior é Aceitar doações, com o subtítulo Trula, um crachá e um interruptor. O interruptor atua no momento em que o liga — não está à espera do botão de salvar. Com ele desligado, o crachá diz Desativado e nada é recebido.
4. Pressione Abrir o painel da Trula. Isto abre trula.io no seu navegador normal. A dica diz onde procurar: a Trula coloca este token no link do painel dock do OBS, no seu painel da Trula.
5. Cole o link completo em Token do painel dock — o aplicativo lê o token a partir dele. Colar apenas o token também funciona, se for isso que tem.
6. Pressione Salvar Configurações no canto superior direito. Ela reporta o seu estado — Salvando…, depois Salvo, ou Erro. Após salvar com sucesso, a página se fecha e regressa à lista de serviços.
7. Salvar com o campo vazio e nenhum token armazenado ainda é recusado com "Por favor, insira o token do seu painel dock."
8. Reabra a página para verificar. O campo do token está vazio de propósito — um token armazenado nunca é mostrado de volta. A sua existência é indicada pela mensagem dentro do campo: "Token salvo — deixe em branco para mantê-lo". Deixar o campo vazio e pressionar Salvar Configurações o mantém inalterado; para mudar de conta, cole o novo por cima.
9. O crachá ao lado do interruptor lhe diz o estado da conexão: Não conectado (ainda sem token), Desativado (o interruptor está desligado), Conectando…, Novo token necessário, Erro de conexão, ou Conectado.
10. Novo token necessário significa que o token armazenado já não funciona — mais frequentemente, foi reemitido no painel. Obtenha o link do painel dock novamente e salve-o por cima do antigo.

Uma recusa não é tomada como definitiva na hora. Se a Trula já aceitou este token antes, o aplicativo responde a uma recusa com uma pausa e uma nova tentativa: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos, e depois da pausa o aplicativo recupera as doações que chegaram nesse meio-tempo. Novo token necessário aparece depois de dez minutos de recusas, ou depois de dois a três minutos se a Trula ainda não aceitou o token desde que o aplicativo foi aberto ou as configurações foram salvas. Mesmo assim o token é testado de novo a cada cinco minutos, então o crachá volta ao normal sozinho assim que a Trula o aceitar. Para um token que a Trula nunca aceitou, o aplicativo pede outro na hora.

O que chega, e como é contado

• Uma doação da Trula chega como um evento de doação normal, portanto os alertas, objetivos, o leilão e a voz sintetizada a captam sem saberem nada sobre a Trula.
• A Trula aceita apenas rublos, e o valor é convertido para a sua moeda base da mesma forma que qualquer outro serviço.
• O nome do doador chega com a doação. Uma doação enviada anonimamente aparece como anônima, e o nome da conta da plataforma por trás dela não é revelado.

O que é normal aqui

• As doações que chegaram enquanto o aplicativo estava fechado não são repetidas. A Trula funciona 24 horas por dia e as doações chegam à noite; sem esta regra, o início da manhã reproduziria todas de uma vez — o carrossel girando pela noite, a voz sintetizada em fila durante minutos, os contadores de desafios enchendo com o dinheiro de ontem.
• O custo dessa regra vale a pena conhecer: uma doação perdida durante uma falha de rede no minuto antes de reiniciar o aplicativo se perde para sempre. Perder uma doação é o lado mais barato da troca.
• O cartão de conexão não mostra nenhum nome de conta. O token do painel dock não fornece um, e o nome em uma doação pertence ao espectador, não a você.
• Os pedidos de música não são gerenciados aqui. Não há lista de músicas, nem pular faixa, nem player no aplicativo; tudo isso é feito na Trula.