Configurações do StreamEngine

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 → StreamEngine é onde o StreamEngine recebe o link para o seu feed de mensagens, para que os pagamentos cheguem ao aplicativo. Duas coisas vivem aqui: o interruptor Aceitar pagamentos e o próprio link.

O StreamEngine não é bem como os outros serviços de doações. Um espectador lá não lhe envia uma transferência — eles compram algo que acontece na sua tela: virá-la durante dez segundos, desfocar a câmera, ou colocar uma música na fila. O dinheiro chega como uma doação normal, e o aplicativo também transporta o que foi comprado.

Como configurar

1. Abra Conexões → Monetização e pressione Conectar StreamEngine 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 do StreamEngine, com "Conecte o StreamEngine para receber doações, efeitos na tela e solicitações de mídia." por baixo.
3. A linha superior é Aceitar pagamentos, com o subtítulo StreamEngine, um indicador 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 indicador diz Desativado e nada é recebido.
4. Pressione Abrir o painel do StreamEngine. Isto abre streamengine.app no seu navegador normal. O link de que precisa é aquele para o widget do feed de mensagens — o endereço que colaria no OBS como uma fonte de navegador.
5. Cole o link completo em Link do painel de dock. Não tente extrair um token dele: o aplicativo precisa de dois valores desse endereço e os obtém sozinho.
6. Pressione Salvar Configurações no canto superior direito. O botão reporta o seu estado — Salvando…, depois Salvo, ou Erro. Após salvar com sucesso, a página se fecha sozinha e regressa à lista de serviços.
7. Salvar com o campo vazio e sem link armazenado ainda é recusado com "Por favor, cole o link do painel de dock."
8. Reabra a página para verificar. O campo do link está vazio de propósito — um link armazenado nunca lhe é mostrado de volta, porque é uma chave para o seu feed. A sua existência é indicada pela mensagem dentro do campo: "Link salvo — deixe vazio para mantê-lo". Deixar o campo vazio e pressionar Salvar Configurações o mantém inalterado; para mudar de conta, cole o novo link por cima.
9. O indicador ao lado do interruptor lhe diz o estado da conexão: Não conectado (ainda sem link), Desativado (o interruptor está desligado), Conectando…, Novo link necessário, Erro de conexão, ou Conectado.
10. Novo link necessário significa que o link está incompleto, é da página errada, ou foi reemitido no painel do StreamEngine. Copie o link completo novamente e salve-o por cima do antigo.

O que chega, e como é contado

• Um pagamento do StreamEngine chega como um evento de doação normal, por isso os alertas, objetivos, o leilão e a voz sintetizada o captam sem serem informados sobre o StreamEngine.
• O valor é aquele que o espectador pagou, antes das taxas do serviço e de pagamento — o mesmo número que eles viram ao pagar.
• O valor é convertido para a sua moeda base, tal como todos os outros serviços.
• O que foi comprado viaja com o dinheiro. Onde o StreamEngine o reporta, o alerta o adiciona ao lado do nome — "Screen Flip ×6 · 10s" — e o feed de eventos no Painel de Controle mostra a mesma linha. As estatísticas também o guardam, para que duas compras ao mesmo preço permaneçam distinguíveis mais tarde.
• Os objetivos, o leilão e o carrossel ignoram o item comprado de propósito: eles funcionam com o valor, e o que foi comprado não altera as suas decisões.
• O nome do doador chega com o pagamento. Um pagamento enviado sem nome aparece como anônimo.

O que é ignorado de propósito

O feed do StreamEngine não é só do StreamEngine. Ele também transporta eventos do Twitch, DonationAlerts e Trovo se os tiver conectado lá.

O aplicativo retira apenas os pagamentos próprios do StreamEngine dele. Tudo o que pertence a outra plataforma é ignorado, porque os seus próprios conectores já os entregam: sem isto, cada seguidor seria acionado duas vezes e uma doação do DonationAlerts seria contada nos seus objetivos duas vezes.

Mais três tipos são ignorados, cada um pela sua própria razão:

• Doações importadas — uma doação puxada para o StreamEngine de outro serviço. É provável que tenha esse serviço conectado diretamente, e seria contado duas vezes.
• Assinaturas do StreamEngine — não é um pagamento único.
• Pré-visualizações do painel do StreamEngine — mostrar um efeito para experimentá-lo não é dinheiro, e inflacionar os seus objetivos com isso estaria errado.

Um pedido de mídia gratuito também é ignorado: um evento sem dinheiro não é uma doação.

O que é normal aqui

• Uma recusa não é tomada como definitiva na hora. Se o StreamEngine já aceitou esse link antes, o app responde à recusa com uma pausa e uma nova tentativa: 5 segundos, depois 10, 20 e assim por diante, até cinco minutos. O indicador mostra Erro de conexão a partir da terceira recusa seguida, e Novo link necessário só depois que as recusas duram dez minutos sem nenhuma resposta aceita (dois minutos logo depois de iniciar ou salvar). Mesmo assim o link é testado de novo a cada cinco minutos, e o indicador volta ao normal sozinho assim que o StreamEngine o aceitar. Um link que o StreamEngine nunca aceitou pede uma troca na hora.
• Os pagamentos que chegaram enquanto o aplicativo estava fechado não são repetidos. O feed guarda cerca de dois dias de histórico, e sem esta regra, iniciar o aplicativo de manhã reproduziria os pagamentos de anteontem — o carrossel girando, voz sintetizada em fila durante minutos, contadores de desafios enchendo com o dinheiro de ontem.
• Mas eles também não se perdem. Na próxima inicialização, eles vão para Estatísticas sem alerta: aparecem na aba Dados, e um pagamento feito durante uma transmissão que o aplicativo registrou também conta nos totais dessa transmissão e em Principais doadores. Os objetivos, o carrossel e o leilão continuam ignorando esses pagamentos. O feed entrega só os seus 25 eventos mais recentes de qualquer tipo, então depois de uma noite movimentada os pagamentos mais antigos podem faltar.
• O custo dessa regra vale a pena conhecer: um pagamento feito durante uma falha de rede no minuto antes de você reiniciar o aplicativo fica sem alerta e não conta para os objetivos, o carrossel nem o leilão. Mesmo assim ele chega a Estatísticas na próxima inicialização, como os outros pagamentos feitos com o aplicativo fechado. Perder um alerta é o lado mais barato da troca.
• O aplicativo verifica o feed a cada três segundos, por isso um alerta normalmente aparece dentro desse tempo.
• O cartão de conexão não mostra nenhum nome de conta. O StreamEngine não fornece um com o link do feed, e o nome em um pagamento pertence ao espectador, não a você.