Twitch

Steuert den eigenen Twitch-Kanal: Clips und Marker setzen, Titel ändern, Werbung starten, im Chat schreiben. Der Chat lässt sich als Widget auf dem Display mitlesen.

Eigenschaft	Wert
Fach	Streaming & Chat
Schlüssel	twitch (so heißt das Plugin in Makros)
Bei frischer Installation	aus (im Marktplatz einschalten)
Befehle	6
Einrichtung	3 Felder, dazu der Knopf „Bei Twitch anmelden“

Wofür

Den eigenen Twitch-Kanal per Taste steuern: Clips und Marker setzen, den Titel ändern, Werbung starten, im Chat schreiben. Außerdem lässt sich der Chat als Widget auf dem Display mitlesen.

Twitch hat keinen anonymen Weg: Jeder Befehl ändert etwas an einem Kanal und braucht deshalb eine Anmeldung mit deinem Konto. Das Plugin ist nicht eingerichtet, solange du nicht angemeldet bist, und tut dann nichts.

Einrichten: bei Twitch anmelden

Feld	Hinweis
OAuth-Token	geheim: wird nach dem Speichern nie wieder angezeigt
Chat als Seite auf dem Display zeigen (ja/nein)	Beispiel: nein
Welcher Kanal (leer = der eigene)	Beispiel: der eigene

1. Plugins → Twitch → Aktivieren → Einrichten, unten links Bei Twitch anmelden.
2. Dein Browser öffnet die Freigabeseite von Twitch. Bestätige dort. Twitch zeigt sie immer, auch wenn du schon einmal zugesagt hast, damit beim Wechsel des Kontos nicht wortlos das alte zurückkommt.
3. Das Token kommt direkt zurück und wird gespeichert. Du besorgst es nie von Hand.
4. Der Dialog zeigt Angemeldet als <Kanalname>, der Zustand wird verbunden.

Die Anmeldung braucht kein Geheimnis. Die Antwort kommt über localhost (Port 9848) zurück, nur auf deinem Rechner.

Zugesagt werden diese Rechte, und nicht mehr:

Recht	Wofür
clips:edit	Clip erstellen
channel:manage:broadcast	Titel ändern, Marker setzen
channel:edit:commercial	Werbung starten
user:write:chat	Chat-Nachricht senden
chat:read	Chat mitlesen (für das Widget)

Ein Satz für alle ist der erträgliche Kompromiss: Wer nur Clips schneidet, soll nicht den Chat mitfreigeben müssen, wer alles nutzt, aber auch nicht viermal gefragt werden.

Die Software prüft das Token alle fünf Minuten. Ist es abgelaufen oder zurückgezogen, steht der Zustand auf getrennt. Melde dich dann noch einmal an.

Befehle

Befehl	Name im Makro	Felder	Passt auf
Bei Twitch anmelden	twitch.sign_in	—	Taste
Clip erstellen	twitch.create_clip	—	Taste
Marker setzen	twitch.create_marker	description Beschreibung	Taste
Titel ändern	twitch.set_title	title Neuer Titel *	Taste
Werbung starten	twitch.start_commercial	length Sekunden	Taste
Chat-Nachricht senden	twitch.send_chat	message Nachricht *	Taste

* ist ein Pflichtfeld.

• Clip erstellen: schneidet einen Clip der letzten Sekunden. Twitch erlaubt das nur, während dein Kanal live ist.
• Marker setzen: setzt eine Markierung im Stream. Beschreibung ist freiwillig und wird auf 140 Zeichen gekürzt. Auch das geht nur im laufenden Stream.
• Titel ändern: setzt den Titel des Streams.
• Werbung starten: Sekunden ist freiwillig, ohne Angabe 30. Twitch erlaubt nur bestimmte Längen und nur für Kanäle, die Werbung schalten dürfen (Partner und Affiliates), im laufenden Stream.
• Chat-Nachricht senden: schreibt als du in deinen Chat.

Lehnt Twitch einen Befehl ab, steht der Grund in der Meldung („twitch 401: …“, „twitch 403: …“).

Der Chat als Widget

1. Setze in den Einstellungen Chat als Seite auf dem Display zeigen (ja/nein) auf ja. Vorgabe ist nein: Mitlesen ist etwas anderes als Senden, und wer es nicht bestellt hat, soll keine Verbindung zum Chat aufbauen. (Die Beschriftung stammt aus der Zeit, als der Chat eine eigene Seite war. Heute ist er ein Widget.)
2. Optional Welcher Kanal (leer = der eigene): der Kanal, dessen Chat du lesen willst.
3. Lege auf der Seite des Masters das Widget Twitch-Chat auf eine Seite. Es ist 5 × 3 Zellen groß.

Widget	Größe (Zellen)	Felder
Twitch-Chat	5 × 3	—

Wie Widgets auf das Display kommen, steht unter Das Display.

So funktioniert das Mitlesen:

• Es läuft über IRC (eine Verbindung, auf der Zeilen ankommen), nicht über eine aufwendigere Schnittstelle. Für „zeig die letzten Nachrichten“ ist das die ehrlichere Größe.
• Der Chat wird nicht gespeichert. Es werden nur die letzten 40 Zeilen gehalten, jede auf 200 Zeichen gekürzt. Was herausfällt, ist weg. Ein Mitschnitt wäre etwas anderes als eine Anzeige.
• Bricht die Verbindung ab, versucht die Software es mit wachsendem Abstand (von 2 bis 60 Sekunden) neu.
• Ohne eingeschaltetes Mitlesen bleibt die Liste leer. Eine Seite, die behauptet, es sei nichts geschrieben worden, wäre schlimmer als eine leere.

Gut zu wissen

• Das Plugin ist bei einer frischen Installation aus.
• Die Zustandszeile zeigt „Angemeldet als <Kanal>“ und, wenn das Mitlesen läuft, dessen Zustand.
• „Keine Twitch-Anwendung hinterlegt (TWITCH_CLIENT_ID)“ heißt: Diese Fassung kennt die Twitch-Anwendung nicht. Das ist ein Problem der Fassung, nicht deiner Einstellungen.
• Dasselbe Token wie bei der Anmeldung reicht für alles. Du trägst es nie von Hand ein.