Twitch: чат, события и баллы канала

Что приходит из Twitch

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

• Сообщения чата со значками, смайликами и цветом ника, который выбрал зритель.
• Фолловеры и подписки, разложенные на разные случаи: новая, продление с числом месяцев, подарочная с именем дарителя. Уровень 1/2/3 или Prime.
• Битсы — вместе с сообщением, которое зритель написал, и со значком, который он выбрал, а не одной суммой.
• Битсы приходят ещё и деньгами: они двигают шкалу сбора и попадают в заработанное за стрим. Бит считается за один цент США (столько Twitch платит за бит) в пересчёте на вашу базовую валюту; задайте свой курс, если считаете иначе.
• Рейды — с каналом, откуда пришли, и с числом зрителей, которые пришли вместе с ним.
• Покупки наград за баллы, включая текст, который зритель вписал в награду.
• Опросы и прогнозы — от запуска до результата, начаты они здесь или на самом Twitch.
• Число зрителей, пока канал в эфире, а также название и категория, под которыми он идёт.

Чем приложение управляет на Twitch

Связь не только на чтение. Что именно ей можно — ровно то, что вы разрешили при авторизации, и на странице настроек каждое право стоит рядом с функцией, которой оно принадлежит.

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

Баллы канала как триггер

Это та часть, которая превращает функцию Twitch во всё остальное в приложении. Награда не самоцель — это кнопка, за нажатие которой зрители платят.

• Покупка запускает сценарий: сцену OBS, источник или фильтр, звук, произнесённую вслух фразу, сообщение в чат, умную розетку.
• Покупка поднимает ставку в аукционе — вы выбираете, какие награды в нём участвуют и с какой цены они считаются.
• Список наград синхронизируется с Twitch: в приложении видно то же, что видят зрители на канале.
• Награды, созданные здесь, и награды, созданные в панели Twitch, показаны отдельно: через API можно управлять только первыми.
• Награда с пропуском очереди помечается выполненной сразу, как только её купили, — поэтому баллы за неё вернуть уже нельзя.

Чем это не является

Twitch — сервис в интернете, а это программа на вашем компьютере, которая с ним разговаривает. Отсюда несколько границ, о которых честнее сказать прямо.

• Это не бот в облаке: пока приложение закрыто, в вашем чате не сидит ничего нашего.
• Это не замена Twitch. Подписки, битсы и баллы остаются его — приложение их читает и на них реагирует.
• Как и самому эфиру, ему нужен интернет: связь идёт с Twitch, и без неё читать нечего.
• Оно не трогает награды, которых не создавало: Twitch разрешает приложению управлять только своими. Остальные видно, но не достать.
• Это не сервис модерации: кнопки модерации делают ровно то, что позволено вашему аккаунту на вашем канале, и не больше.

Что происходит с доступом

Авторизация — та часть, к которой правильно относиться настороженно, поэтому стоит сказать точно.

• Вы авторизуетесь на странице самого Twitch — пароля приложение не видит.
• Токен шифруется хранилищем ключей вашей операционной системы и не покидает компьютер.
• Своего аккаунта разработчика заводить не нужно, и ключи никуда не вставляются: авторизация идёт через само приложение strAImer.
• Каждое выданное право стоит рядом с функцией, которую оно открывает: у «вот это не работает» появляется ответ, на который можно посмотреть, а не догадка.
• Токены обновляются до того, как истекут, и связь возвращается сама после обрыва сети; а когда Twitch отказывает окончательно, приложение об этом говорит, а не ходит по кругу молча.
• Второй аккаунт подключается, чтобы приложение писало от имени бота и ваше имя не стояло под каждым автоматическим сообщением. Чтение всегда идёт через ваш канал — бот только отправляет.

Где всё это видно

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

• Тайл «Эфир: Чат» на пульте: все подключённые чаты одной лентой, отправка — из того же поля.
• Тайл «Эфир: События» ведёт список: кто зафолловил, кто подписался, кто прислал битсы, кто что купил.
• Тайл «Эфир: Зрители» показывает число зрителей, которое отдаёт Twitch, пока канал в эфире.
• Алерты, сборы средств и аукцион берут те же события — соединять их с подключением не надо.
• «Статистика стримов» сохраняет их после эфира, и цифры не уходят вместе с сессией.

Из чего собрано

Каждая часть — отдельный модуль: ставите только нужные, и любой можно убрать, не сломав остальное.

Как начать

1. Откройте Подключения → Каналы, нажмите «подключить» и подтвердите доступ на странице Twitch.
2. Подключите второй аккаунт в разделе Подключения → Боты, если не хотите, чтобы приложение писало под вашим именем.
3. Откройте Автоматизация → Баллы канала и создайте награды, которые зрители будут покупать, или подхватите уже заведённые.
4. Привяжите награду к сценарию в разделе Автоматизация → Сценарии или отметьте её как участвующую в аукционе.
5. Если бит стоит для вас не один цент США, задайте свой курс: Настройки → Курсы валют.

Twitch разрешает каналу 50 наград всего — кем бы они ни были созданы, — а награду, заведённую в панели Twitch, через API править нельзя вовсе: это правило площадки, не наше. Приложение показывает, какие из ваших наград оно трогать может, а какие нет.

Работает вместе с