Настройки Trula

Ставится отдельно: модуль не входит в установщик приложения. Откройте Каталог модулей → Дополнительные и нажмите Установить на его карточке; до этого его в приложении нет.

Что это за страница

Подключения → Монетизация → Trula — это место, где Trula получает токен из своей док-панели OBS, чтобы донаты доходили до приложения. Здесь находятся две вещи: переключатель Приём донатов и сам токен.

В Trula донат и запрос музыки — это одно и то же действие: зритель платит, и трек попадает в очередь. Приложение получает только донатную половину: сумму, имя и сообщение. Очередь треков и плеер остаются в Trula, поэтому заказанный трек strAImer не показывает и не играет; музыку оставьте плееру самой Trula.

Как это настроить

1. Откройте Подключения → Монетизация и нажмите Подключить Trula на карточке. На уже подключённой карточке откроется та же страница с кнопкой Настроить. Стрелка вверху слева, Назад, возвращает к списку.
2. Страница называется Настройки Trula, с подписью "Настройте интеграцию с Trula для получения уведомлений о донатах." под заголовком.
3. Верхняя строка — это Приём донатов, с подписью Trula, со значком и переключателем. Переключатель действует в момент переключения — он не ждёт кнопку сохранения. Когда он выключен, значок показывает Выключено, и ничего не поступает.
4. Нажмите Открыть кабинет Trula. Он откроет trula.io в вашем обычном браузере. Подсказка говорит, где искать: Trula кладёт этот токен в ссылку док-панели для OBS, она в кабинете Trula.
5. Вставьте всю ссылку в поле Токен док-панели — приложение само извлечёт из неё токен. Если у вас есть только сам токен, то вставка только токена тоже сработает.
6. Нажмите Сохранить в правом верхнем углу. Кнопка отчитается о результате — Сохраняю…, затем Сохранено, или Ошибка. После успешного сохранения страница закроется сама и вернёт вас к списку сервисов.
7. Попытка сохранить с пустым полем, если токен ещё не был сохранён, будет отклонена с сообщением "Введите токен док-панели.".
8. Откройте страницу снова, чтобы проверить. Поле с токеном пустое специально — сохранённый токен никогда не показывается вам обратно. О его существовании говорит подсказка внутри поля: "Токен сохранён — оставьте поле пустым, чтобы не менять". Оставьте поле пустым и нажмите Сохранить, чтобы оставить токен нетронутым; чтобы сменить аккаунт, вставьте новый токен поверх старого.
9. Значок рядом с переключателем показывает состояние подключения: Не подключено (токена ещё нет), Выключено (переключатель выключен), Подключение…, Нужен новый токен, Ошибка соединения, или Подключено.
10. Нужен новый токен означает, что сохранённый токен больше не работает — чаще всего его перевыпустили в кабинете. Получите ссылку для док-панели снова и сохраните её поверх старой.

Отказ не считается окончательным сразу. Если Trula уже принимала этот токен, на отказ приложение отвечает паузой и новой попыткой: 5 секунд, потом 10, 20 и так далее, до пяти минут, а после паузы догоняет донаты, пришедшие за это время. Нужен новый токен появляется, когда отказы идут десять минут, а если с запуска приложения или сохранения настроек Trula ещё ни разу не приняла токен, хватает двух-трёх минут отказов. Но и тогда токен пробуется снова раз в пять минут, поэтому значок вернётся сам, как только Trula его примет. Токен, который Trula не принимала ни разу, сразу просит замены.

Что приходит и как это считается

• Донат из Trula приходит как обычное событие доната, поэтому алерты, цели, аукцион и озвучка подхватывают его, даже не зная о Trula.
• Trula принимает только рубли, и сумма конвертируется в вашу базовую валюту так же, как и с любым другим сервисом.
• Имя донатера приходит вместе с донатом. Анонимный донат показывается как анонимный, и имя аккаунта платформы, с которого он отправлен, не раскрывается.

Что здесь является нормой

• Донаты, пришедшие, когда приложение было закрыто, не воспроизводятся повторно. Trula работает круглосуточно, и донаты приходят ночью; без этого правила утренний запуск воспроизвёл бы их все разом — карусель прокручивала бы ночные донаты, озвучка ставилась бы в очередь на несколько минут, счётчики челленджей заполнялись бы вчерашними деньгами.
• Цену этого правила стоит знать: донат, потерянный из-за сбоя сети за минуту до перезапуска приложения, потерян навсегда. Потеря одного доната — это меньшая из сторон этой сделки.
• На карточке подключения не отображается имя аккаунта. Токен док-панели его не выдаёт, а имя в донате принадлежит зрителю, а не вам.
• Запросами музыки здесь не управляют. Списка треков, пропуска трека и плеера в приложении нет: всё это делается в Trula.