Twitch-Einrichtung und EventSub – Social Stream Ninja

Twitch-Quellmodus auswählen

Modus	Am besten für	Wichtiger Unterschied
Standard	Einfache öffentliche Chaterfassung aus einer Twitch-Chat- oder Popout-Seite.	Liest, was die Seite bereitstellt. Das ist einfach, bietet aber nicht alle EventSub-Ereignisse.
WebSocket / EventSub	Follows, Abonnements, Bits, Belohnungen, Raids, Stream-Status, Hype Trains, Moderationssynchronisierung, Chatversand und Kanaldetails.	Erfordert Twitch OAuth. Ereignisse werden nur aktiviert, wenn angemeldetes Konto, Kanalrolle, Kanalberechtigung und erteilter Berechtigungsbereich dies erlauben.

Einrichtung in der Desktop-App

Auswählen Quelle hinzufügen → Twitch.
Gib den Twitch-Kanal-Loginnamen aus seiner URL ein. Für twitch.tv/examplechannel, gib Folgendes ein: examplechannel.
Lass WebSocket für die umfangreichere EventSub-Quelle ausgewählt. Twitch verwendet diesen Modus derzeit standardmäßig in der App.
Auswählen Quelle aktivieren (Activate source), dann Bei Twitch anmelden.
Erlaube die angeforderten Berechtigungen und lasse das Twitch-Quellfenster geöffnet.

Anmeldebildschirm der Twitch-Quelle mit den Anmeldemethoden External browser und Local app — Die Desktop-Quelle bietet einen OAuth-Ablauf im externen Browser und einen innerhalb der lokalen App. Der externe Browser ist meist am einfachsten, wenn Twitch bereits in deinem normalen Browser funktioniert.

EventSub mit Browser-Erweiterung einrichten

Installiere und aktiviere die aktuelle Social Stream Ninja Erweiterung.
Öffne Twitch-EventSub-Quellseite.
Ersetze examplechannel in der URL durch den Kanal-Loginnamen, den du überwachen möchtest.
Auswählen Bei Twitch anmelden und genehmige den angeforderten Zugriff.
Lasse diese Seite geöffnet. Prüfe vor dem Testen von Benachrichtigungen, ob die Felder User und Channel korrekt sind.

https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

Öffne für einfache Standard-Erfassung stattdessen die normale Twitch-Chat- oder Popout-Chat-Seite und halte den Chat sichtbar.

Was Twitch anfordert

Social Stream fordert ein Benutzertoken mit den Berechtigungen an, die für die unterstützten Steuerungen und Abonnements erforderlich sind. Ein erteilter Berechtigungsbereich macht ein Konto nicht zum Sender oder Moderator; Twitch prüft weiterhin die Rolle des Kontos für den gewählten Kanal.

Berechtigungsgruppe	Verwendet für
Chat	Chat lesen, Chat senden und Chatter auflisten.
Follower und Abonnenten	Follower-Ereignisse, Abonnentenereignisse, verschenkte Abonnements und Verlängerungsnachrichten.
Bits, Belohnungen und Hype Trains	Cheers, eingelöste benutzerdefinierte Kanalpunkt-Belohnungen und Hype-Train-Status.
Moderation	Nachrichtenlöschung, Sperren/Timeouts und Blockiersynchronisierung, wenn das Konto den Kanal moderieren darf.
Kanalverwaltung	Titel und Kategorie lesen/ändern, Werbung lesen/verwalten und Kanalmetriken anzeigen.

Siehe Twitchs offizielle Referenz der Berechtigungsbereiche und EventSub-Abonnementtypen.

Von der aktuellen Quelle verarbeitete Ereignisse

Follows: new_follower.
Abonnements: new_subscriber, resub, und subscription_gift.
Bits: cheer mit einem Spendenwert.
Kanalpunkte: reward.
Raids: raid.
Stream- und Werbestatus: stream_online, stream_offline, und ad_break.
Hype Train: hype_train Updates zu Beginn, Fortschritt und Ende.
Moderation: Updates zu Sperren und Nachrichtenlöschungen, sofern erlaubt.

Twitch-Abonnentenereignisse erfordern einen berechtigten Affiliate-/Partner-Kanal und Senderzugriff. Für Follow- und Moderationsabonnements muss der angemeldete Nutzer je nach Ereignis der Sender oder ein berechtigter Moderator sein.

Namen nachgelagerter Benachrichtigungen und Nutzdatenfelder findest du in folgenden Dokumenten: Leitfaden zur Kompatibilität von Ereignissen und Meldungen und Ereignisreferenz.

Erste Prüfungen bei fehlenden Ereignissen

Prüfe auf der Quellseite, ob diese Angaben korrekt sind: Benutzer und Kanal.
Lasse die Quellseite bzw. das Quellfenster geöffnet und prüfe, ob die Chatverbindung aktiv ist.
Wenn Chat funktioniert, Follows/Abonnements/Belohnungen aber nicht, melde dich ab und autorisiere erneut, damit die aktuellen Berechtigungsbereiche erteilt werden.
Prüfe, ob das angemeldete Konto der Sender oder ein berechtigter Moderator dieses Kanals ist.
Prüfe, ob Dock und Benachrichtigungs-Overlay dieselbe Social-Stream-Sitzungs-ID verwenden.
Verwende die simulierte Testnachricht im Popup oder die Multi-Alerts-Vorschau, um Erfassungsprobleme von Overlay-Problemen zu unterscheiden.

EventSub kann eine Benachrichtigung mehrmals zustellen. Twitch dokumentiert eine mindestens einmalige Zustellung. Social Stream enthält einen Schutz vor Duplikaten, aber eigene API-Verbraucher sollten nach Möglichkeit trotzdem anhand der Ereignis-/Nachrichtenidentität deduplizieren. Siehe die offizielle EventSub-Übersicht.