Сумісність подій і сповіщень

Підключайте захоплені події платформ до Multi Alerts, не плутаючи звичайний чат, донати та дані подій.

Почніть із джерела події

Multi Alerts показує події, які Social Stream уже захопив. Він сам не входить у Twitch, Kick, YouTube, TikTok або іншу платформу.

  1. Підключіть і активуйте джерело платформи, що надає подію.
  2. Залишайте цю сторінку джерела або вікно джерела окремого застосунку активним.
  3. Використовуйте однаковий ID сесії Social Stream у джерелі, спливному вікні, доку й URL Multi Alerts.
  4. Перевірте оверлей сповіщень через його параметри перед налагодженням підключення платформи.

Успішний перегляд підтверджує роботу макета сповіщення. Це не доводить, що джерело платформи має дозвіл отримувати цю живу подію.

Категорії Multi Alerts

КатегоріяПоширені назви подійПримітки
Підпискаnew_follower, follow, followedПотребує джерела, що захоплює події підписки, і необхідного дозволу платформи.
Платна підпискаnew_subscriber, resub, subscription_gift, псевдоніми членстваВключає повторювані, подаровані події та події членства, де підтримуються.
Донат / подарунокsuperchat, supersticker, gift, tip, псевдоніми донатівРядок чату у стилі донату натомість може використовувати hasDonation і donoValue.
Бітиcheer, bitsСуму можна фільтрувати параметром мінімального донату/грошової суми.
Рейдraid, host, redirectДоступність і назви залежать від джерела платформи.
Аукціонauction_updateСповіщення про перемоги в аукціонах вмикаються окремо.
Hype Trainhype_trainСповіщення Hype Train вмикаються окремо й потребують відповідного доступу Twitch EventSub.

Кількість глядачів, загальні підписники, стан трансляції та рекламної перерви є оновленнями, а не звичайними картками сповіщень. Використовуйте Довідник подій під час створення споживача API або власного оверлею.

Основні події платформ

Це поточні канонічні назви подій, коли вибраний режим джерела може доставити відповідну активність.

АктивністьYouTubeTwitchKick
Новий учасник / підписник sponsorship new_subscriber new_subscriber
Поновлення resub resub resub
Подароване членство / підписка giftpurchase, giftredemption subscription_gift subscription_gift
Платна підтримка superchat, supersticker, jeweldonation cheer, або рядок із hasDonation gift для подарунків KICKs; donation для подій підтримки/чайових. Обидва заповнюють hasDonation.
Підписка / сповіщення про публічного підписника new_follower; із затримкою API та лише публічні підписки new_follower new_follower
Винагорода каналу - reward reward
Рейд / хостинг - raid Вхід лише для сумісності; не поточна офіційна підписка подій Kick

Примітка щодо рейдів Kick: Social Stream приймає застарілі дані у формі raid/host для сумісності, але поточний офіційний каталог подій Kick не має підписки raid/host. Не робіть процес Kick залежним від отримання такої події.

Режими Standard і WebSocket

ПлатформаСтандартне захопленняЗахоплення WebSocket / API
YouTube Платні повідомлення, членство, подарунки членства, оновлення глядачів і обмежені події, визначені сторінкою. Спільні платні події/події учасників, а також віхи членства, сповіщення про недавніх публічних підписників і підтримувані оновлення лічильників.
Twitch Винагороди, відображені в чаті, повідомлення про подаровані підписки, оновлення глядачів і кілька сповіщень лише сторінки. EventSub додає підписників, платні підписки, поновлення, cheers, рейди, винагороди й підтримувані події лічильників/стану, коли обліковий запис і дозволи це дозволяють.
Kick Чат і легкі позначки сторінки для подарунків, винагород та оновлень глядачів. Офіційні події підписок, платних підписок, подарунків, використання винагород, KICKs, модерації та стану ефіру після автентифікації.

Режим WebSocket зазвичай є правильним вибором для сповіщень на основі подій. Стандартне захоплення залишається корисним, коли потрібен лише відображений чат або автентифікація недоступна.

Увімкніть потрібні типи сповіщень

Відкрийте параметри Multi Alerts у налаштуваннях Social Stream. Підписки, платні підписки, донати, біти й рейди мають власне ввімкнення, стиль, звук і оформлення. Сповіщення Auction і Hype Train потребують окремих спеціальних перемикачів.

Параметри Social Stream Ninja Multi Alerts з окремим керуванням типами сповіщень для підписок, платних підписок, донатів, бітів, рейдів, перемог в аукціонах і Hype Trains
Налаштуйте кожну категорію сповіщень окремо. Увімкнення сповіщення не надає дозволу платформи, потрібного для його захоплення.
  • Використовуйте Черга сповіщень коли кілька подій можуть надходити разом.
  • Перевірте фільтри джерел, якщо події працюють у доку, але не в Multi Alerts.
  • Перевірте фільтри мінімальної суми/донату, коли невеликі чайові або cheers відсутні.
  • Один раз взаємодійте зі сторінкою браузера, якщо правила автовідтворення блокують власний звук сповіщення.

Перегляньте перед виходом у прямий ефір

Використовуйте засоби попереднього перегляду для перевірки вибраної категорії, тексту, суми, медіа, звуку, анімації та поведінки черги.

Попередній перегляд донату Multi Alerts зі стилізованою карткою донату й засобами керування переглядом
Попередній перегляд донату перевіряє оверлей. Потім запустіть або дочекайтеся справжньої події платформи, щоб перевірити підключення джерела.

Які поля використовує кожен інструмент

ІнструментПравило сумісності
Multi AlertsКласифікує канонічні event назви, псевдоніми, hasDonation, поля членства й вибрані meta значення в спільні категорії.
Потоки подійЗіставте точні type, event, і поля, які надсилає ваше джерело. Скористайтеся інструментом Test Message, перш ніж покладатися на живу подію.
ОзвученняРядки подій типово пропускаються, якщо не мають стилю донату. Додайте &readevents коли повідомлення подій без донатів мають озвучуватися, потім застосуйте звичайні фільтри озвучення.
Скарбничка донатів / лічильник ціліЗвичайний режим використовує суми донатів. Режим ажіотажу також може оцінювати поля членства, поновлення й подарованого членства.
Власний оверлей / споживач APIВикористовуйте канонічні поля даних із довідника подій. Приймайте задокументовані псевдоніми лише для зворотної сумісності.

Використовуйте Створити тестові повідомлення щоб перевірити очікувану подію та Рецепти потоків подій для робочих прикладів автоматизації.

Примітки щодо налаштування платформ

ПлатформаПерша перевіркаПосібник
TwitchУвійдіть як транслятор або дозволений модератор і залишайте EventSub підключеним.Налаштування Twitch EventSub
KickСвідомо виберіть режим джерела й пройдіть автентифікацію, якщо потрібні офіційні події її потребують; не очікуйте офіційної події рейду.Налаштування й автентифікація Kick
Інші джерелаПереконайтеся, що вибране джерело справді надсилає цей тип події, а не лише повідомлення чату.Підтримувані сайти

Коли справжнє сповіщення відсутнє

  1. Переконайтеся, що джерело отримало подію у власному журналі, доку або виводі API.
  2. Переконайтеся, що джерело й сторінка Multi Alerts використовують однакові ID сесії та пароль.
  3. Переконайтеся, що категорію ввімкнено й не виключено фільтрами джерела або каналу.
  4. Перевірте фільтри мінімального значення для донатів і бітів.
  5. Для Twitch або Kick увійдіть повторно, якщо чат працює, а захищені події — ні.
  6. Залиште вікно джерела активним достатньо довго, щоб побачити справжню подію; сам перегляд не є наскрізною перевіркою платформи.

Якщо залучено кілька пристроїв або режимів підключення, перегляньте Сесії, паролі та режими пересилання.