Команда !игра с текущей категорией стрима в чат-боте

Откуда бот получает название текущей игры

Команда !игра обычно показывает не приложение, запущенное на компьютере, а текущую категорию канала на Twitch. Стример меняет игру или категорию в панели управления трансляцией, а бот получает это значение через встроенную переменную либо запрос к API.

Если в панели Twitch осталась прошлая игра, выбрана категория «Общение» или поле не заполнено, бот выведет то же значение. Сам по себе чат-бот не распознаёт игру на экране: он работает с данными, которые передаёт площадка или внешняя автоматизация.

Сначала обновите категорию канала на Twitch

Перед настройкой команды проверьте, где вы меняете категорию: в панели Creator Dashboard, через программу для управления стримом или через интеграцию с ботом. Важен итоговый статус канала, который видят зрители на странице трансляции.

После смены игры не рассчитывайте на мгновенное обновление во всех сервисах. Бот может хранить последнее значение в кэше, а площадка — передавать обновлённые данные с задержкой. Для команды !игра лучше менять категорию до начала эфира и отдельно проверять ответ в чате.

Команда !игра в Nightbot

В Nightbot откройте Custom Commands, создайте команду !игра и укажите сообщение с переменной Twitch. Для текущего канала обычно используют такой ответ: «Сейчас играем в: $(twitch game $(channel))».

Переменная $(channel) подставляет канал, в котором вызвана команда, а $(twitch game ...) запрашивает его категорию. Если бот обслуживает несколько каналов, этот вариант удобнее, чем вручную вписывать логин стримера в каждой команде.

• Command: !игра
• Message: Сейчас играем в: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: установите задержку, чтобы не засорять чат одинаковыми ответами

Недостаток Nightbot — ограниченная логика ответа. Обработать пустую категорию, несколько вариантов текста или данные из собственного расписания без дополнительных обходных решений будет сложно.

Команда с категорией в StreamElements

В StreamElements переменная текущей игры обычно добавляется в ответ команды как ${game}. В разделе Chat bot создайте команду !игра и задайте текст: «Текущая игра: ${game}».

Перед сохранением проверьте команду в чате зрительским аккаунтом. Если бот не подключён к нужному каналу или категория канала не обновилась, переменная может вернуть старое значение либо пустой текст. Настройки прав и задержки находятся там же, в параметрах команды.

• Command: !игра
• Response: Текущая игра: ${game}
• Permission: Everyone
• Cooldown: подберите под активность чата

Недостаток StreamElements — команда зависит от интеграции самого сервиса с Twitch. При сбое авторизации или задержке синхронизации вы не сможете вручную исправить ответ без изменения команды.

Как вывести категорию через Streamer.bot

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

В подкоманде Send Message укажите, например: «Сейчас играем в: %gameName%». Затем привяжите Action к команде !игра в разделе Commands. Если в вашей сборке Streamer.bot имя аргумента отличается, сначала запустите действие в тестовом режиме и посмотрите список аргументов, который вернула подкоманда Twitch.

Недостаток Streamer.bot — больше ручной настройки. Нужно самостоятельно связать команду, действие, доступ бота к чату и авторизацию Twitch, поэтому ошибка на любом этапе оставит команду без ответа.

Запрос категории через Twitch API

Кастомный бот, скрипт или Action в Streamer.bot может получать категорию напрямую через Twitch API. Для этого сначала узнайте числовой идентификатор канала: запрос GET https://api.twitch.tv/helix/users?login=логин_канала возвращает данные пользователя, включая id.

Далее используйте запрос GET https://api.twitch.tv/helix/channels?broadcaster_id=ID_КАНАЛА. В ответе API есть поле game_name — это название текущей категории, которое можно отправить в чат в ответ на !игра.

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

Порядок настройки API-команды

1. Создайте приложение в панели разработчика Twitch и получите Client ID.
2. Получите токен с доступом к данным канала и сохраните его в настройках своего бота или скрипта.
3. Определите broadcaster_id канала через endpoint users по логину.
4. Отправляйте запрос к endpoint channels с broadcaster_id.
5. Берите из ответа поле game_name и формируйте сообщение для чата.
6. Если game_name пустое, выводите нейтральный текст вместо пустого ответа.

Не опрашивайте API на каждое сообщение в чате. Практичнее обновлять значение при первом вызове !игра, сохранять его на время задержки команды и повторно получать данные после истечения кэша. После ручной смены категории можно принудительно обновить значение отдельной модераторской командой.

Как обновлять категорию и не получать старый ответ

Если вы меняете игру прямо во время эфира, сначала обновите категорию на Twitch, затем подождите, пока новое значение появится на странице канала, и только после этого проверяйте !игра. Если бот использует кэш, очистите его или дождитесь следующего запроса к API.

Для одного канала обычно достаточно обновлять категорию по вызову команды, а не запускать постоянный опрос. Если нужен автоматический мониторинг, делайте проверку с умеренным интервалом и учитывайте ограничения API. Частые запросы не сделают данные точнее, но могут привести к ограничениям со стороны площадки.

Недостаток прямого API-подхода — нужно следить за токеном. После отзыва доступа, смены пароля, изменения прав приложения или ошибки авторизации команда может начать выводить старую категорию либо перестать отвечать.

Распознавание игры на компьютере и его ограничения

Отдельный инструмент распознавания нужен только тогда, когда категория Twitch не меняется вручную. Такая автоматизация отслеживает запущенный процесс, данные игровой платформы, активное окно или телеметрию, сопоставляет игру с категорией Twitch и обновляет канал через API.

После этого бот по-прежнему читает категорию Twitch, а не содержимое экрана. Автоматизация лишь меняет данные канала за вас. Она может ошибиться, если игра запущена через лаунчер, используется браузерная версия, название процесса не совпадает с игрой или стример переключился на другую программу.

Недостаток распознавания — его нужно отдельно настраивать и контролировать. Для стримов с несколькими играми, модами, эмуляторами и техническими сценами ручная смена категории нередко надёжнее.

Пустая категория, несколько игр и ручной текст

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

Для пустой категории подготовьте понятный ответ: «Текущая категория пока не указана» или «Сейчас разговорный эфир». В Nightbot и StreamElements такая обработка может потребовать отдельной команды или ручной смены текста. В кастомном API-скрипте можно проверить, пусто ли поле game_name, и подставить запасной вариант.

Ручная команда остаётся рабочим резервом: «Сейчас играем в: название игры». Недостаток очевиден — её легко забыть обновить после смены игры, и зрители будут получать неверную информацию.

Права, задержка и проверка перед эфиром

Основную команду !игра обычно оставляют доступной всем зрителям, но добавляют cooldown. Это снижает повтор одинаковых сообщений, когда несколько человек одновременно спрашивают игру. Команду очистки кэша, ручного обновления текста или перезапуска Action оставьте модераторам и владельцу канала.

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

1. Укажите нужную игру или категорию в панели Twitch.
2. Убедитесь, что новое название видно на странице канала.
3. Проверьте, что чат-бот подключён именно к вашему каналу.
4. Вызовите !игра с обычного зрительского аккаунта.
5. Смените категорию и повторите вызов после обновления кэша или задержки команды.
6. Проверьте ответ при пустой категории и во время разговорного эфира.
7. Если используется API, проверьте срок действия токена и журнал ошибок запроса.