ZeasyAlexandClaude Opus 5.5
54dbe1265b
Paket bauen und veroeffentlichen / paket (push) Successful in 42s
- ingest wuerfelt beim ersten Start einen Schluessel und meldet sich beim Hub; der antwortet 202, bis im Pult jemand auf Freigeben tippt - nach dem Verbinden schickt der Hub die Adresse von /sounds, ingest legt Szene "abdulive Ton" mit der Browser-Source an und haengt sie in jede Szene - fern:verbinden bleibt als Weg von Hand Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@abdulive/overlay-server
Der einzige Server, der von außen erreichbar ist. Liefert die Seiten aus
overlay-web aus, hält den Ereignisstrom dorthin
offen und bringt Einrichtung und OAuth-Rückruf unter dieselbe Adresse.
/ Übersicht mit den Adressen für OBS Passwort
/setup Einrichtung: Twitch-Apps, Tokens Passwort
/callback OAuth-Rückruf von Twitch offen, `state` schützt
/alerts … die Browser-Sources Schlüssel in der URL
/events der Ereignisstrom dahinter Schlüssel in der URL
/pult Steuerpult fürs Handy (PWA) Passwort
/soundboard/… Sounds hochladen, ändern, spielen Passwort (Datei: Schlüssel)
/fern/… Leitung zum Stream-PC für OBS eigener Schlüssel im Kopf
Der Fern-Schlüssel ist der dritte Zugang und der einzige, der etwas schaltet:
er steht deshalb nie in einer Adresse, sondern in authorization: Bearer ….
Server-Sent Events statt WebSocket
chat-control.md skizziert einen
WS-Kanal. Es sind SSE geworden, aus drei Gründen:
- Node bringt einen WebSocket-Client mit, aber keinen Server. Den müsste man selbst schreiben, inklusive Handshake und Rahmenformat - in einem Projekt ohne Abhängigkeiten heißt das: selbst pflegen.
EventSourceverbindet sich von allein neu. Die tote Browser-Source nach einem Neustart ist der häufigste Fehler bei solchen Overlays, und hier löst ihn der Browser.- Die Richtung stimmt. Das Overlay hört nur zu; es sendet nie.
Drei Dinge halten die Verbindung ehrlich:
- Herzschlag alle 15 s, als echtes Ereignis und nicht als SSE-Kommentar - ein Kommentar hält die Verbindung offen, ist im Browser aber unsichtbar.
- Wachhund im Client: 45 s ohne Nachricht heißt neu verbinden. OBS hält eine tote Verbindung erstaunlich lange für lebendig.
- Schnappschuss beim Verbinden: der letzte Stream-Zustand und die letzten Chatnachrichten, damit die Quelle nach dem Neuverbinden nicht leer im Bild steht.
Zugang
Siehe ADR-0008.
- Passwort für alles, was ein Mensch bedient. Setzen mit
abdulive web:passwort, nie über das Netz - ein Dienst, bei dem man das Passwort über die offene Weboberfläche setzen kann, hat kein Passwort. - Schlüssel in der Adresse für die Browser-Sources. Eine Browser-Source kann kein Formular ausfüllen. Der Schlüssel darf nur lesen und lässt sich auf der Übersichtsseite neu würfeln.
Ohne publicUrl bindet der Server weiter auf 127.0.0.1 und verhält sich wie
vorher.