Настройки Trula

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

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

В Trula донат и запрос музыки — это одно и то же действие: зритель платит, и трек попадает в очередь.

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

1. Откройте Подключения → Монетизация и нажмите Connect Trula на карточке. На уже подключённой карточке откроется та же страница с кнопкой Настроить. Стрелка вверху слева, Назад, возвращает к списку.
2. Страница называется Настройки Trula, с подписью "Configure Trula to receive donation notifications." под заголовком.
3. Верхняя строка — это Приём донатов, с подписью Trula, со значком и переключателем. Переключатель действует в момент переключения — он не ждёт кнопку сохранения. Когда он выключен, значок показывает Выключено, и ничего не поступает.
4. Нажмите Открыть кабинет Trula. Он откроет trula.io в вашем обычном браузере. Подсказка говорит, где искать: Trula помещает этот токен в ссылку для док-панели OBS, в вашем кабинете Trula.
5. Вставьте всю ссылку в поле Токен док-панели — приложение само извлечёт из неё токен. Если у вас есть только сам токен, то вставка только токена тоже сработает.
6. Нажмите Сохранить в правом верхнем углу. Кнопка отчитается о результате — Saving…, затем Сохранено, или Ошибка. После успешного сохранения страница закроется сама и вернёт вас к списку сервисов.
7. Попытка сохранить с пустым полем, если токен ещё не был сохранён, будет отклонена с сообщением "Please enter your dock panel token.".
8. Откройте страницу снова, чтобы проверить. Поле с токеном пустое специально — сохранённый токен никогда не показывается вам обратно. О его существовании говорит подсказка внутри поля: "Token saved — leave empty to keep it". Оставьте поле пустым и нажмите Сохранить, чтобы оставить токен нетронутым; чтобы сменить аккаунт, вставьте новый токен поверх старого.
9. Значок рядом с переключателем показывает состояние подключения: Не подключён (токена ещё нет), Выключено (переключатель выключен), Connecting…, Нужен новый токен, Connection error, или Connected.
10. Нужен новый токен означает, что сохранённый токен больше не работает — чаще всего его перевыпустили в кабинете. Получите ссылку для док-панели снова и сохраните её поверх старой.

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

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

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

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