Обработка донатов DA / ODA для Streamer.bot
Модуль автоматически обрабатывает входящие донаты из DonationAlerts и OpenDonationAssistant, приводит суммы к единой валюте и передает данные в Streamer.bot для дальнейших действий, триггеров и автоматизации стрима.
Основные возможности
Автоматическая обработка донатов
Модуль принимает донаты из DonationAlerts и OpenDonationAssistant и формирует для каждого события набор переменных, которые можно использовать в действиях Streamer.bot.
В действия передаются:
user — имя отправителя
curenncy — исходная валюта доната
amount— исходная сумма
amount.converted — сумма, пересчитанная в рубли
donation_source — источник доната: DA или ODA
Это позволяет строить любые сценарии: запуск анимаций, звуков, OBS-сцен, сообщений в чат, мини-игр, рулеток и других реакций на донаты.
Конвертация валют
Все входящие суммы автоматически пересчитываются в RUB и укладываются в переменную amount.converted. Это удобно, если донаты приходят в разных валютах, но логика стрима должна работать по единой рублевой шкале.
Например, можно настроить реакцию не на исходные USD, EUR или другую валюту, а на итоговую сумму в рублях.
Пулы донатов
Модуль позволяет группировать донаты по суммам и автоматически создавать для них отдельные триггеры в Streamer.bot.
Поддерживаются два типа пулов:
Точные пулы
Срабатывают только на конкретную сумму.
Например:
100 RUB
500 RUB
999 RUB
Так можно настроить отдельные реакции на фиксированные суммы донатов.
Диапазонные пулы
Срабатывают, если сумма попадает в заданный диапазон.
Например:
от 500 до 1000 RUB
от 1000 до 3000 RUB
Это удобно для уровней донатов: маленький, средний, крупный и так далее.
Отдельные триггеры для разных источников
Для каждого пула модуль создает события отдельно по источникам:
- Донаты DonationAlerts
- Донаты OpenDonationAssistant
- Общий триггер для любого источника
Благодаря этому можно делать как общую реакцию на донат, так и отдельную логику для DonationAlerts или ODA.
Автоматическая очистка триггеров
Модуль следит за актуальностью созданных пулов и автоматически удаляет устаревшие триггеры из дерева событий Streamer.bot. Для удаления требуется перезапуск Стримербот.
Если пользователь удалил или изменил пул, лишние события не остаются в боте и не засоряют список триггеров.
Интеграция с MiniChat
Модуль может отправлять системные сообщения в чат через MiniChat (сообщения имеют отдельный статус System) и при должной настройке, не видны зрителям.
Поддерживаются уведомления:
о подключении;
о потере соединения;
о новых донатах;
о необходимости повторной авторизации;
о проблемах с токеном или сессией.
Уведомления о донатах могут содержать имя отправителя, сумму, валюту, эквивалент в рублях и текст сообщения.
Авторизация
Oauth авторизация.
Ни каких токенов и секретных ключей - жмешь кнопку "подключить", логинишься в сервис в появившемся окне и все.