Донаты: семь сервисов, один поток событий

Почему они один раздел, а не пять

Донат — это донат. Всё, что дальше — алерт, полоса цели, ставка в аукционе, строка для озвучки — реагирует на событие, а не на сервис, который его доставил.

• Можно подключить несколько сервисов одновременно без конфликтов.
• Добавление сервиса позже ничего не меняет в вашей настройке: алерты и цели подхватывают его как есть.
• YouTube Super Chats тоже приходят как донаты, так что они идут в общую цель.

Когда зритель платит за действие, а не за перевод

Переводы продают не все. На StreamEngine зритель покупает то, что произойдёт у вас на экране — перевернуть его на десять секунд, размыть камеру, сломать видеокарту, — а на Trula заказывает трек. Деньги приходят обычным донатом, но одна сумма не говорит, что сейчас случится.

• Там, где сервис это сообщает, алерт называет покупку: «Переворот Экрана ×6 · 10 сек» рядом с ником.
• Лента событий на Панели управления показывает ту же строку — и живьём, и в истории.
• Статистика её сохраняет, поэтому две покупки по одной цене остаются различимы и потом.
• Цели сборов, аукцион и карусель её намеренно не смотрят: они работают с суммой.

Одна валюта, или числа теряют смысл

Зрители платят в той валюте, которую дают их платформа и карта, а полоса цели должна показывать одно число. Эта конвертация — отдельный модуль, потому что ошибка в ней незаметно портит все итоги, которые вы видите потом.

• Три онлайн-источника курсов с резервом, так что отказ одного не остановит подсчёт.
• Фиксированные локальные курсы на случай полного отсутствия интернета.
• Базовая валюта задаётся один раз в настройках приложения, и всё остальное следует ей.
• Аукцион и порог доната для ИИ используют ту же конвертацию, так что установленный порог означает одно и то же, независимо от валюты зрителя.

История без пропусков

Приложение не работает круглосуточно, а донаты его не ждут.

• История DonationAlerts подгружается и сверяется после переподключения, так что в статистике нет пробелов, когда приложение было закрыто.
• Донат, пришедший, пока вы были офлайн, всё равно попадает в итоги того стрима.

Из чего собрано

Каждая часть — отдельный модуль: ставите только нужные, и любой можно убрать, не сломав остальное.

Как начать

1. Установите базовую валюту в Настройки → Локализация.
2. Подключите сервисы донатов, которые вы реально используете.
3. Отправьте тестовый донат и проверьте, что он доходит до оверлея алертов.
4. Направьте на него цели, аукцион и озвучку — они уже слушают.

Работает вместе с