Donaciones: siete servicios, un flujo de eventos

Por qué son una sola sección y no cinco

Una donación es una donación. Todo lo que viene después — la alerta, la barra de meta, la puja en la subasta, la línea que se lee en voz alta — reacciona al evento, no al servicio que lo entregó.

• Varios servicios pueden conectarse a la vez sin conflictos.
• Añadir un servicio más tarde no cambia nada en tu configuración existente: las alertas y las metas lo recogen tal cual.
• Los YouTube Super Chats también llegan como donaciones, por lo que cuentan para la misma meta.

Cuando un espectador paga por una acción, no por una transferencia

No todos los servicios venden transferencias. En StreamEngine un espectador compra algo que ocurre en tu pantalla — dale la vuelta durante diez segundos, difumina la cámara, rompe la tarjeta de vídeo — y en Trula ponen una canción en cola. El dinero es una donación como cualquier otra, pero la cantidad por sí sola no dice lo que va a pasar.

• Cuando el servicio lo informa, la alerta nombra la compra: "Pantalla Volteada ×6 · 10s" junto al espectador.
• El feed de eventos en el Panel de Control muestra la misma línea, en directo y en el historial.
• Las estadísticas lo guardan, así que dos compras al mismo precio se distinguen después.
• Las metas, la subasta y el carrusel lo ignoran a propósito: funcionan con la cantidad.

Una moneda, o los números dejan de significar algo

Los espectadores pagan en la moneda que su plataforma y su tarjeta les den, mientras que una barra de meta tiene que mostrar un solo número. Esa conversión es un módulo aparte, porque equivocarse corrompe silenciosamente cada total que veas después.

• Tres fuentes de tasas en línea con respaldo, para que una caída no detenga el conteo.
• Tasas locales fijas para cuando no hay internet en absoluto.
• La moneda base se establece una vez, en la configuración de la app, y todo lo demás la sigue.
• La subasta y el umbral de donación de la IA usan la misma conversión, así que un umbral que establezcas significa una cosa sin importar en qué pagó el espectador.

Un historial sin huecos

La app no está funcionando las 24 horas, y las donaciones no la esperan.

• El historial de DonationAlerts se rellena y concilia tras una reconexión, así que las estadísticas no tienen un hueco cuando la app estaba cerrada.
• Una donación que llegó mientras estabas desconectado aún se suma a los totales de esa transmisión.

De qué está hecho

Cada parte es un módulo separado: instalas solo los que necesitas, y cualquiera de ellos se puede eliminar sin romper el resto.

Cómo empezar

1. Establece tu moneda base en Configuración → Localización.
2. Conecta los servicios de donaciones que realmente usas.
3. Envía una donación de prueba y comprueba que llega a la superposición de alertas.
4. Dirige las metas, la subasta y la voz en off hacia ella — ya la están escuchando.

Funciona junto con