Doações: sete serviços, um só fluxo de eventos

Tudo o que conta como dinheiro, em uma lista só

Uma doação é uma doação. Tudo o que vem depois — o alerta, a barra de meta, o lance no leilão, a linha lida em voz alta — reage ao evento, não ao serviço que o entregou.

• DonationAlerts, DonatePay, DonateX, Streamlabs e StreamElements trazem as doações conforme elas chegam.
• O StreamEngine traz efeitos pagos na tela e pedidos de mídia pagos, além das doações comuns.
• O Trula traz doações, incluindo aquelas com que o espectador paga para colocar uma música na fila.
• Os bits da Twitch, os Super Chats do YouTube e as figurinhas pagas do YouTube também chegam como doações, então contam para a mesma meta.
• Vários serviços funcionam ao mesmo tempo sem conflito, e adicionar um depois não muda nada no que você já configurou.

Quando o espectador paga por uma ação, não por uma transferência

Nem todo serviço vende transferências. No StreamEngine o espectador compra algo que acontece na sua tela — virá-la por dez segundos, desfocar a câmera, quebrar a placa de vídeo — e no Trula ele coloca uma música na fila. O dinheiro chega como qualquer outra doação, mas o valor sozinho não diz o que está prestes a acontecer.

• Onde o serviço informa isso, o alerta dá o nome da compra: “Tela invertida ×6 · 10 s” ao lado do espectador.
• O feed de eventos no Painel mostra a mesma linha, ao vivo e no histórico.
• As estatísticas guardam isso, então duas compras pelo mesmo preço continuam distinguíveis depois.
• As metas, o leilão e o carrossel ignoram isso de propósito: eles trabalham com o valor.
• O StreamEngine informa o efeito que vendeu; o Trula não envia o nome da música, então os pedidos musicais dele chegam como doações comuns.

O que acontece sem você mexer em nada

Você não escreve uma regra para uma doação. Ela chega, e tudo o que já está escutando reage a ela.

• O alerta dispara na sobreposição — o nome, o valor e a mensagem.
• A barra de meta avança, o leilão conta o lance e a doação cai no pote do carrossel — o giro, e atrás dele o contador de desafios, acontecem quando o pote chega ao valor que você definiu.
• A voz sintetizada lê a mensagem em voz alta, acima do limite que você definiu.
• As estatísticas registram isso nos totais daquela transmissão e no ranking de doadores.
• Seus próprios cenários rodam, se você escreveu algum.

O que ele não vai fazer

Trazer o dinheiro é todo o trabalho dele. Tudo o que poderia inflar um número em silêncio ficou de fora.

• Ele só recebe: os saques, os estornos e a página em que o espectador paga continuam com o serviço.
• Doações que chegaram com o aplicativo fechado não são repetidas como alertas — abrir de manhã tocaria a noite inteira de uma vez.
• O feed do StreamEngine traz também eventos da Twitch, do DonationAlerts e da Trovo. Eles são ignorados de propósito, senão a mesma doação seria contada duas vezes.
• Uma pré-visualização disparada no painel do StreamEngine, e um pedido sem custo, nunca chegam à barra de meta: dinheiro que não existe não tem o que fazer ali.
• Uma doação de teste feita no painel do DonateX chega sim aos alertas — é para isso que ela serve — e chega marcada como teste, para que tudo o que não deve contá-la, o leilão acima de tudo, a deixe de fora.

Uma só moeda, ou os números param de significar alguma coisa

Os espectadores pagam na moeda que a plataforma e o cartão deles oferecem, enquanto a barra de meta precisa mostrar um número só. Essa conversão é um módulo à parte, porque errar nela corrompe em silêncio todos os totais que você olhar depois.

• Três fontes de câmbio online com reserva, para que a queda de uma delas não pare a contagem.
• Taxas que você define na mão para o que nenhuma fonte conhece — os bits da Twitch acima de tudo, pelo preço que você realmente recebe por eles.
• A moeda base é definida uma vez, em Configurações → Localização, e todo o resto segue ela.
• A barra de meta, o leilão, o carrossel e o limite da voz sintetizada leem o valor já convertido, então um limite que você define significa a mesma coisa, não importa em que moeda o espectador pagou.

Um histórico sem buracos

O aplicativo não fica ligado o tempo todo, e as doações não esperam por ele.

• Todo o histórico do DonationAlerts é importado uma vez, na primeira conexão; depois disso as doações recentes são conferidas com o serviço — vinte segundos após conectar e a cada quinze minutos — então uma noite com o aplicativo fechado não deixa buraco nas estatísticas.
• Essa importação vai direto para as estatísticas em vez de passar pelos alertas: os totais ficam completos sem repetir a noite passada na tela.
• Os pagamentos do StreamEngine feitos com o aplicativo fechado chegam às estatísticas do mesmo jeito na próxima vez que ele abrir, sem alerta. O feed do StreamEngine só entrega os últimos 25 eventos de qualquer tipo, então uma pausa longa ou movimentada ainda pode deixar uma lacuna. As metas, o carrossel e o leilão não contam esses pagamentos.
• As duas importações pulam qualquer serviço que você desmarcou em “Contar doações de”, na aba “Configurações” de Estatísticas, igual à contagem ao vivo.
• Se o socket ficar em silêncio enquanto a conexão ainda aparece como ativa, a conferência prova isso: o cartão diz “Não está recebendo” e oferece Reconectar.

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. Defina sua moeda base em Configurações → Localização.
2. Abra Conexões → Monetização e conecte os serviços que você realmente usa.
3. Se você aceita bits da Twitch, dê uma taxa a eles em Configurações → Taxas de Câmbio.
4. Envie uma doação de teste e verifique se ela chega à sobreposição de alertas.
5. Aponte as metas, o leilão e a voz sintetizada para esse fluxo — eles já estão escutando.

Sete serviços hoje, e a lista cresce a partir do mesmo lugar: um serviço novo é mais um conector, e tudo o que vem depois já está escutando.

Funciona em conjunto com