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

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

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

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

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

Что означают четыре формулировки статуса

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

Значок считывается при открытии страницы, поэтому формулировка, изменившаяся, пока вы находились на странице, появится после того, как вы выйдете через Назад и откроете её снова.

Аккаунт бота

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

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

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

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

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

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