Настройки StreamEngine

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

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

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

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

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

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

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

• Платёж StreamEngine приходит как обычное событие доната, поэтому алерты, цели, аукцион и озвучка подхватывают его, вообще не зная о StreamEngine.
• Сумма — это та, которую заплатил зритель, до вычета комиссий сервиса и платёжной системы — то же число, которое он видел при оплате.
• Сумма конвертируется в вашу базовую валюту, так же как и у всех других сервисов.
• Что было куплено, путешествует вместе с деньгами. Где StreamEngine сообщает об этом, алерт добавляет это рядом с именем — "Screen Flip ×6 · 10s" — и лента событий на Панели управления показывает ту же строку. Статистика тоже её сохраняет, так что две покупки по одной цене остаются различимыми позже.
• Цели, аукцион и карусель намеренно игнорируют купленный предмет: они работают с суммой, и то, что было куплено, не меняет их решения.
• Имя донатера приходит с платежом. Платёж, отправленный без имени, показывается как анонимный.

Что намеренно пропускается

Лента StreamEngine — это не только StreamEngine. Она также несёт события из Twitch, DonationAlerts и Trovo, если вы подключили их там.

Приложение берёт из неё только собственные платежи StreamEngine. Всё, принадлежащее другой платформе, пропускается, потому что ваши собственные коннекторы уже доставляют это: без этого каждый подписчик срабатывал бы дважды, а донат DonationAlerts засчитывался бы в ваши цели два раза.

Ещё три вида пропускаются, и каждый по своей причине:

• Импортированные донаты — донат, перенесённый в StreamEngine из другого сервиса. Скорее всего, у вас этот сервис подключён напрямую, и он засчитался бы дважды.
• Подписки StreamEngine — не разовый платёж.
• Превью из кабинета — показать эффект, чтобы попробовать его, — это не деньги, и раздувать ими ваши цели было бы неправильно.

Бесплатный медиазапрос тоже пропускается: событие без денег — это не донат.

Что здесь нормально

• Отказ не считается окончательным сразу. Если StreamEngine уже принимал этот ссылку, на отказ приложение отвечает паузой и новой попыткой: 5 секунд, потом 10, 20 и так далее, до пяти минут. Значок показывает Ошибка подключения с третьего отказа подряд, а Нужна новая ссылка только после того, как отказы идут десять минут без единого принятого ответа (две минуты сразу после запуска или сохранения). Даже тогда ссылку пробуется снова раз в пять минут, и значок вернётся сам, как только StreamEngine его примет. Ссылка, который StreamEngine не принимал ни разу, сразу просит замены.
• Платежи, пришедшие, когда приложение было закрыто, не воспроизводятся. Лента хранит около двух дней истории, и без этого правила запуск приложения утром воспроизводил бы позавчерашний день — карусель крутилась бы, озвучка ставилась в очередь на минуты, счётчики челленджей заполнялись вчерашними деньгами.
• Но и не пропадают. При следующем запуске они попадают в раздел Статистика без алерта: их видно на вкладке Данные, а платёж, пришедший во время стрима, который записало приложение, учитывается ещё и в итогах этого стрима и в списке Топ донатеры. Цели, карусель и аукцион по-прежнему их не замечают. Лента отдаёт только 25 последних событий любого вида, поэтому после насыщенной ночи самых старых платежей может не хватать.
• Цену этого правила стоит знать: платёж, пришедший во время сетевого сбоя за минуту до перезапуска приложения, останется без алерта и не попадёт в цели, карусель и аукцион. В раздел Статистика он всё равно попадёт при следующем запуске, как и другие платежи, пришедшие при закрытом приложении. Пропущенный алерт здесь меньшее из двух зол.
• Приложение проверяет ленту каждые три секунды, поэтому алерт обычно появляется в течение этого времени.
• На карточке подключения не отображается имя аккаунта. StreamEngine не выдаёт его с ссылкой на ленту, а имя в платеже принадлежит зрителю, а не вам.