Интеграция с Twitch

Встроен в strAImer: модуль ставится вместе с приложением, скачивать ничего не нужно. Он есть в списке Каталог модулей → Встроенные.

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

Страница подключает аккаунт Twitch к приложению — как сказано в описании, "Настройте интеграцию с Twitch для получения сообщений чата, наград и управления каналом." Она существует в двух вариантах: ваш собственный канал и отдельный аккаунт, от имени которого пишет бот.

Считать битсы донатом живёт на вкладке канала. Чиры приходят ещё и донатом, поэтому битсы двигают цели сборов, ставки аукциона и суммы эфира — по курсу из «Настройки → Курсы валют». Выключите, чтобы вести битсы отдельно от денег; счётчик битсов остаётся в любом случае. Именно он и делает так, что чир двигает сбор средств или ставит ставку на аукционе; выключенным он оставляет битсы отдельным счётчиком. Из коробки бит стоит один цент США (столько Twitch платит за бит) в пересчёте на вашу базовую валюту; свой курс в «Настройки → Курсы валют» заменяет это значение.

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

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

1. Откройте Подключения → Каналы и откройте страницу Twitch. Её заголовок гласит Аккаунт Стримера (Чтение событий, EventSub).
2. Статус подключения показывает одну из пяти формулировок. Подсказка рядом с ним называет, что запрашивается: "Требуются максимальные разрешения (чтение чата, управление стримом, опросами, прогнозами и баллами канала)."
3. Нажмите Авторизовать через браузер. На странице одна кнопка и нет поля для токена: вход открывается в вашем обычном браузере и завершается там.
4. Браузер сразу уходит на страницу подтверждения самого Twitch, код на ней уже подставлен. Войдите там в Twitch, если он попросит, подтвердите код и разрешите доступ. Итог показывает сам Twitch, а не страница strAImer, поэтому страницы «Авторизация успешна!» в конце не будет. Вкладку браузера после этого можно закрыть.
5. Пока вы в браузере, страница модуля пишет "Завершите вход в окне браузера — страница обновится сама." Через две минуты надпись меняется: "Всё ещё ждём браузер. Завершите вход там — страница обновится сама. Если это займёт время, ничего не потеряется." Не нажимайте кнопку повторно, пока этот вход открыт: новое нажатие начинает новый вход, и тот, что в браузере, уже не засчитается. Через тридцать минут страница сдаётся: "Вход не состоялся. Окно браузера закрыли или в доступе отказали — нажмите кнопку и попробуйте ещё раз." Отказ на Twitch отсюда выглядит так же: страница ждёт до этого срока.
6. Когда вход прошёл, страница модуля сообщает Конфигурация Twitch успешно сохранена! и через мгновение закрывается. Имя аккаунта (логин) теперь показывает подключённый логин; поле только для чтения.
7. Появляется Выданные разрешения — "Какие функции доступны с текущим токеном". Каждая функция отмечена галочкой или крестиком, на вкладке канала двенадцать строк: Чтение и отправка сообщений в чат, События новых фолловеров, События платных подписок, События битсов, Награды за баллы канала, События Hype Train, События целей канала, Опросы, Прогнозы, Изменение названия и категории стрима, Создание клипов, Модерация: бан и удаление сообщений.
8. Если что-то отмечено крестиком, появляется предупреждение: "Некоторых прав не хватает — соответствующие функции работать не будут. Переавторизуйтесь, чтобы выдать все права." Кнопка Переавторизовать рядом с ним запускает тот же вход через браузер, и именно это добавляет недостающие права.
9. Стрелка вверху слева, Назад, покидает страницу.

Что означают пять формулировок статуса

• Подключено как {username} — зелёный. Аккаунт сохранён, и ни Twitch, ни модуль не отказали ему. Это подтверждает: вход действителен. Это не проверка в реальном времени, поступают ли события в данную секунду.
• Подключение... — жёлтый, имя аккаунта остаётся на экране. Модуль поднимает связь: сразу после запуска приложения и каждый раз, когда оборвалась одна из её половин, чат или поток событий. Обе возвращаются сами, поэтому обычно статус зеленеет за секунды.
• Войдите снова для переподключения — жёлтый. Аккаунт всё ещё здесь, и его имя всё ещё показано ниже, потому что вам нужно знать, какой аккаунт чинить, но Twitch отклонил сохранённый доступ и не возобновит его в фоне. Ничего не поступает с канала, пока вы снова не войдёте, и повторный вход единственный способ починки; кнопки, которая обновляет его извне, нет.
• Ошибка подключения — красный. Аккаунт в порядке, а соединение нет: поток событий прервался, или модуль не смог завершить его настройку. Модуль повторяет попытку сам, поэтому этот статус часто проходит без вашего вмешательства.
• Не подключено — красный, и единственный из пяти, который скрывает строку Имя аккаунта (логин), потому что на этой странице ещё не сохранён ни один аккаунт. Это то, что показывает свежая установка.

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

Аккаунт бота

Та же страница в разделе Подключения → Боты имеет заголовок Аккаунт Бота (Отправка ответов в чат), и её подсказка короче: "Требуются права на чтение и отправку сообщений в чат." Вход та же единственная кнопка, Авторизовать через браузер: войдите там под аккаунтом, от имени которого должен писать бот, а не под своим. Его список Выданные разрешения состоит из одной строки, Чтение и отправка сообщений в чат, потому что бот только пишет в чат. Баны и удаление сообщений идут через аккаунт стримера, поэтому Модерация: бан и удаление сообщений стоит на вкладке канала.

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

Если браузер сообщает об ошибке

Вместо страницы Twitch браузер может показать Ошибка авторизации с текстом "Не удалось обменять код авторизации на токены: {error}". Это значит, что вход не удалось даже начать, чаще всего потому, что Twitch был недоступен. Аккаунт остаётся в прежнем состоянии; нажмите Авторизовать через браузер снова.

Что она не может делать

• Нет места, куда можно вставить токен, ключ доступа или ключ обновления. Авторизовать через браузер — единственный способ войти, и это также способ обновить просроченный вход.
• В поле Имя аккаунта (логин) нельзя вводить текст. Чтобы подключить другой аккаунт, войдите под этим аккаунтом.
• Разрешения нельзя выбирать по одному. Список с галочками только сообщает, что несёт текущий вход; Переавторизовать передаёт весь набор снова.
• Нет полей Client ID и Client Secret, и они не нужны: вход происходит через само приложение strAImer.
• На странице нет кнопки Сохранить: всё сохраняется в конце входа через браузер. Тумблер Считать битсы донатом сохраняется в момент переключения.
• Страница не отключает аккаунт и не удаляет подключение, и она не выключает модуль.
• Аккаунт стримера и аккаунт бота настраиваются отдельно: один вход не заполняет другой.