Хочу добавить в свою игру интеграцию с Twitch — с чего начать?
Последнее время я получал вопросы под своими статьями по поводу интеграции Twitch в игру. Постараюсь ответить на примере своей игры TD Worlds, где интеграция вполне себе работает.
Первым делом необходимо решить, какого уровня интеграция вам нужна:
- интеграция при помощи расширения (Twitch Extension), которое отображается в виде панели поверх трансляции. Наверняка вы встречали такие, например для Hearthstone. Игра может передавать в расширение любые нужные данные, а пользователи, в свою очередь, могут взаимодействовать с игрой через панель на трансляции. Является самым трудоемким вариантом интеграции, но, в то же время, даёт много возможностей.
- интеграция при помощи приложения (Twitch App), которое позволяет использовать REST API твича. Его можно использовать, чтобы, например, залогинить пользователя в игру при помощи его twitch аккаунта, чтобы получить необходимые данные для интеграции с его трансляцией. Так же это можно использовать для создания чат-бота игры. Важное уточнение — у твича нет такого понятия как "бот". По сути своей это просто еще один аккаунт пользователя, иногда разработчика, но чаще специально созданного конкретно для того, чтобы быть ботом (сам твич не против этого).
Итак, в своей игре я использовал второй вариант, но в упрощенном виде.
Дело в том, что твич позволяет подключиться к любому чату не только с помощью реального аккаунта (нужен логин и пароль/токен для входа), но и анонимно.
Для анонимного подключения нужно использовать аккаунт, начинающийся на justinfan и дальше несколько цифр. Например, justinfan12321. А пароль должен быть пустым.
Таким образом мы получаем возможность принимать в игре все сообщения нужного нам чата и реагировать на них так, как нам нужно. Но при этом интеграция работает только в одну сторону, поскольку анонимное подключение к чату не разрешает отправлять в него сообщения. Если для вас важна возможность писать что-то в чат, то вам следует идти по пути создания бота.
Ну а сейчас рассмотрим работу интеграции с использованием анонимного подключения с примерами кода. Код будет на GDScript и довольно обобщенный, но суть должна быть ясна. Для Godot я использовал аддон godot-twicil.
Собственно основа очень простая: вы подключаетесь к нужному чату нужным пользователем, и дальше решаете сами, что делать с сообщениями зрителей. Можете выводить чат на экран прямо в игре, можете собирать определенные сообщения в качестве голосования и т.д.
Для своего движка вы можете использовать любую библиотеку, позволяющую подключиться к чату твича, либо же написать что-то свое по документации.
Для своей игры я просто проверял сообщение, чтобы оно совпадало с номером варианта для голосования и запрещал голосовать повторно до конца раунда голосования. То, как замерять время голосования, формировать и выводить варианты, сбрасывать результаты перед новым голосованием, остается полностью на вашей совести. Самое главное, сделать достаточно много интересных вариантов взаимодействия с вашей игрой, чтобы как стример, так и зрители получали от этого удовольствие (или ненависть, тут уже как получится).
В принципе, для ознакомления с основами этого хватит, дальше все зависит от ваших желаний и возможностей, но советую начинать с базовых интеграций. По крайней мере, так вы быстро получите что-то работающее, что потом можно будет развить в нечто бóльшее.
Чисто теоретически, механизмы интеграции с любым стриминговым сервисом будут такими же. Главное, чтобы была официальная возможность считывать сообщения чата.
Удачи!
А тестировать это нормально можно или через жопу, как и в случае с продажей внутриигровых предметов?
Они сделали тестилку для апи, но не в виде хттп-сервера, а в виде консольной тулзы https://github.com/twitchdev/twitch-cli
В случае интеграции с чатом вообще проблем никаких, подключаешься к своему каналу (сам стрим не обязателен, чат доступен всегда) и отправляешь сообщения