Social Stream Ninja
Українська
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Налаштування Twitch та EventSub

Використовуйте звичайне захоплення сторінки для простого чату або режим EventSub/WebSocket для нових підписників, платних підписок, Bits, нагород, рейдів, Hype Train та керування каналом.

Вибір режиму джерела Twitch

РежимНайкраще дляВажлива відмінність
Standard Базове захоплення загальнодоступного чату зі сторінки чату Twitch або окремого вікна чату. Читає те, що надає сторінка. Це просто, але не дає повного набору подій EventSub.
WebSocket / EventSub Нові підписники, платні підписки, Bits, нагороди, рейди, стан трансляції, Hype Train, синхронізація модерації, надсилання повідомлень і відомості про канал. Потребує Twitch OAuth. Події вмикаються лише тоді, коли це дозволяють обліковий запис, у який виконано вхід, роль у каналі, відповідність каналу вимогам і надані дозволи.

Налаштування настільного застосунку

  1. Виберіть Додати джерело → Twitch.
  2. Введіть логін каналу Twitch, який використовується в його URL. Для twitch.tv/examplechannel, введіть examplechannel.
  3. Залиште WebSocket для розширеного джерела EventSub. Наразі застосунок за замовчуванням використовує цей режим для Twitch.
  4. Виберіть Активувати джерело (Activate source), потім Увійти в Twitch.
  5. Надайте запитані дозволи та залиште вікно джерела Twitch відкритим.
Екран входу джерела Twitch зі способами External browser і Local app
Настільне джерело пропонує OAuth через зовнішній браузер і вхід через локальний застосунок. Зовнішній браузер зазвичай найзручніший, якщо Twitch уже працює у вашому звичайному браузері.

Налаштування EventSub у розширенні браузера

  1. Установіть і ввімкніть поточне розширення Social Stream Ninja.
  2. Відкрийте сторінку джерела Twitch EventSub.
  3. Замініть examplechannel в URL логіном каналу, за яким ви хочете стежити.
  4. Виберіть Увійти в Twitch і підтвердьте запитаний доступ.
  5. Залиште цю сторінку відкритою. Перед перевіркою сповіщень переконайтеся, що поля User і Channel правильні.
https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

Для базового захоплення Standard натомість відкрийте звичайну сторінку чату Twitch або окреме вікно чату та залиште чат видимим.

Які дозволи запитує Twitch

Social Stream запитує токен користувача з дозволами, потрібними для підтримуваних елементів керування й підписок. Надання дозволу не робить обліковий запис власником каналу чи модератором; Twitch усе одно перевіряє його роль у вибраному каналі.

Група дозволівПризначення
ЧатЧитання чату, надсилання повідомлень і список учасників чату.
Звичайні та платні підписникиПодії нових підписників, платних підписок, подарованих підписок та повідомлення про поновлення підписки.
Bits, нагороди та Hype TrainCheers, отримання власних нагород за бали каналу та стан Hype Train.
МодераціяВидалення повідомлень, блокування/тимчасові блокування та синхронізація блокувань, коли обліковий запис може модерувати канал.
Керування каналомЧитання/оновлення назви й категорії, читання/керування рекламою та показ показників каналу.

Дивіться офіційний довідник дозволів Twitch і типи підписок EventSub.

Події, які обробляє поточне джерело

  • Нові підписники: new_follower.
  • Підписки: new_subscriber, resub, і subscription_gift.
  • Bits: cheer зі значенням донату.
  • Бали каналу: reward.
  • Рейди: raid.
  • Стан трансляції та реклами: stream_online, stream_offline, і ad_break.
  • Hype Train: hype_train оновлення початку, перебігу й завершення.
  • Модерація: оновлення блокувань і видалення повідомлень, коли це дозволено.

Події платних підписок Twitch потребують каналу рівня Affiliate/Partner, що відповідає вимогам, і доступу власника каналу. Підписки на події нових підписників і модерації потребують входу власника каналу або уповноваженого модератора залежно від події.

Назви сповіщень і поля даних для подальшої обробки наведено в посібниках: Посібник із сумісності подій і сповіщень і Довідник подій.

Що перевірити спочатку, якщо події немає

  1. Переконайтеся, що на сторінці джерела правильно вказано Користувач (User) і Канал.
  2. Залиште сторінку/вікно джерела відкритими й переконайтеся, що підключення до чату активне.
  3. Якщо чат працює, але нові підписники/платні підписки/нагороди — ні, вийдіть і повторно авторизуйтеся, щоб надати поточні дозволи.
  4. Перевірте, що обліковий запис, у який виконано вхід, належить власнику каналу або модератору з потрібними дозволами.
  5. Перевірте, що док та оверлей сповіщень використовують однаковий ID сесії Social Stream.
  6. Скористайтеся штучним тестовим повідомленням зі спливного вікна або попереднім переглядом Multi Alerts, щоб відокремити проблеми захоплення від проблем оверлею.

EventSub може доставляти сповіщення більше одного разу. Twitch документує доставку щонайменше один раз. Social Stream має захист від дублікатів, але власні споживачі API також мають за можливості усувати дублікати за ідентифікатором події/повідомлення. Дивіться офіційний огляд EventSub.