Совместимость событий и уведомлений

Подключите захваченные события платформ к Multi Alerts, различая обычный чат, пожертвования и данные событий.

Начните с источника события

Multi Alerts показывает события, уже захваченные Social Stream. Он сам не входит в Twitch, Kick, YouTube, TikTok или другую платформу.

  1. Подключите и активируйте источник платформы, предоставляющий событие.
  2. Оставьте страницу источника или окно источника отдельного приложения активным.
  3. Используйте одинаковый идентификатор сеанса 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
Рейд / host - raid Вход только для совместимости; не текущая официальная подписка на события Kick

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

Стандартный режим и WebSocket

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

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

Включите нужные типы уведомлений

Откройте параметры Multi Alerts в настройках Social Stream. У фолловеров, подписок, пожертвований, битов и рейдов отдельные элементы включения, стиля, звука и внешнего вида. Уведомления аукционов и Hype Train требуют отдельных переключателей.

Параметры Multi Alerts Social Stream Ninja с отдельным управлением фолловерами, подписками, пожертвованиями, битами, рейдами, победами на аукционах и Hype Train
Настраивайте каждую категорию уведомлений отдельно. Включение уведомления не предоставляет разрешения платформы, необходимые для его захвата.
  • Используйте Ставить уведомления в очередь если несколько событий могут прийти одновременно.
  • Если события видны в док-панели, но не в Multi Alerts, проверьте фильтры источников.
  • Если не видны небольшие чаевые или Cheers, проверьте фильтры минимальной денежной суммы или пожертвования.
  • Один раз взаимодействуйте со страницей браузера, если правила автовоспроизведения блокируют собственный звук уведомления.

Предпросмотр перед эфиром

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

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

Какие поля использует каждый инструмент

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

Используйте Создать тестовые сообщения чтобы проверить ожидаемое событие и Примеры сценариев Event Flow с работающими примерами автоматизации.

Примечания по настройке платформ

ПлатформаПервая проверкаРуководство
TwitchВойдите как ведущий или модератор с нужными правами и держите EventSub подключённым.Настройка Twitch EventSub
KickОсознанно выберите режим источника и завершите аутентификацию, если нужные официальные события её требуют; не ожидайте официального события рейда.Настройка и аутентификация Kick
Другие источникиУбедитесь, что выбранный источник действительно отправляет нужный тип события, а не только сообщения чата.Поддерживаемые сайты

Когда настоящее уведомление не появляется

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

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