OBS-Steuerungsdock-Leitfaden – Social Stream Ninja

Schnelleinrichtung

Öffne in Social Stream Ninja Globale Einstellungen und Werkzeuge → Mechanik.
Öffnen OBS Control Dock and copy its link. Keep Social Stream Ninja active during the stream.
The copied link includes your session, password, and connection settings.
Öffne in OBS Docks → Benutzerdefinierte Browser-Docks.
Nenne das Dock Social-Stream-Steuerung and paste the copied link. For a session without a password or server settings, the URL is:

https://socialstream.ninja/obs-control-dock.html?session=YOUR_SESSION_ID

Auswählen Übernehmen, schließe das Einstellungsfenster und platziere das neue Dock in OBS an der gewünschten Stelle.
Prüfe, ob das Dock diesen Status anzeigt: Verbunden. Wenn die URL keine Sitzung enthielt, gib sie im Dock ein und wähle Speichern & verbinden.

Steuerungsdock öffnen

Welche Servereinstellungen sind erforderlich?

The generated control link follows Social Stream's connection settings. Normal links use P2P. When Dock sendet seine Befehle über den Server an die Erweiterung is enabled, controls use that server connection.

For a manually configured API connection, add &server (oder &server=wss://YOUR_SERVER) and enable Fernsteuerung der Erweiterung über API (remote API control of extension).

OBS's WebSocket-Servereinstellungen von OBS sind davon unabhängig und können ausgeschaltet bleiben.

Mit einem Abspann am Stream-Ende verwenden

Stelle vor dem Stream in den Abspann-Einstellungen den Auslösemodus auf Erfassung im Hintergrund. So kann die App Chatteilnehmer, Mitglieder und Spender sammeln, während die Abspann-Browserquelle geschlossen ist.
Füge die erzeugte Abspann-URL mit derselben Sitzungs-ID zur OBS-Abschlussszene hinzu.
Wechsle am Ende des Streams zuerst zur Abschlussszene, damit die Abspann-Browserquelle geladen und verbunden ist.
Auswählen Abspann starten im OBS-Steuerungsdock.

Vor dem Start laden: die Erfassung im Hintergrund funktioniert bei geschlossener Abspannseite, aber Start, Vorschau und Test benötigen eine verbundene Abspann-Browserquelle, um etwas anzuzeigen.

Siehe Abspann-Leitfaden für Erfassungsmodi, Filter und Fehlerbehebung bei fehlenden Namen.

Was jede Abspann-Schaltfläche tut

Schaltfläche	Ergebnis
Abspann starten	Spielt die tatsächlich gesammelte Liste ab.
Vorschau	Spielt die echte Liste ab, ohne auf der Seite gesammelte Einträge zu verbrauchen.
Abspann testen	Zeigt integrierte Beispiele für Teilnehmer, Mitglieder und Spender. Dies belegt nicht, dass echte Namen gesammelt wurden.
Gespeicherten Abspann zurücksetzen	Leert die gespeicherte Hintergrundsammlung der aktiven Social-Stream-Sitzung.

Produkte & Unterstützungslinks

Öffne in Social Stream Monetarisierung, speichere und aktiviere deine Produkte und wähle dann OBS-Steuerungsdock öffnen. Kopiere diese private Steuerungs-URL in OBS unter Benutzerdefinierte Browser-Docks. Für ein reines Produkt-Dock verwende obs-control-dock.html?session=YOUR_SESSION_ID&commerce.

Keep Social Stream on and use the generated Product Controls link. Add the separate monetization overlay URL as an OBS Browser Source for viewers. The control dock is for you; never share its session URL with viewers.

OBS-Produktsteuerung mit Auswahl gespeicherter Produkte, Dauer, Anzeigen, Weiter, Produkte ausblenden, Zeitplan fortsetzen und Zustand des ausgewählten Produkts

Anzeigen: ein gespeichertes Produkt auswählen und fest anzeigen. Weiter: vom aktuellen Produkt aus weitergehen.
Produkte ausblenden: Werbekarten ausblenden; Aktivitätsmeldungen laufen weiter. Zeitplan fortsetzen: zur gespeicherten Einstellung für erstes Produkt oder Rotation zurückkehren.
Dauer: Anzeigen, Weiter und Ausblenden kehren nach dieser Anzahl Sekunden zum gespeicherten Zeitplan zurück. Verwende 0, um die Überschreibung bis zur nächsten Änderung beizubehalten.
Zustand: aktualisiert sich alle fünf Sekunden, solange dieser Abschnitt geöffnet ist. Er meldet Social Streams Auswahl, nicht die Sichtbarkeit einer OBS-Szene. Verlorene oder unbestätigte Verbindungen deaktivieren Produktschaltflächen, bis der Zustand wieder verfügbar ist.

Dock, Popup, Stream Deck und Event Flow teilen dieselben Steuerelemente. Bearbeite und speichere den Katalog in Social Stream. Siehe Produktsteuerung für Einrichtung und Automatisierung.

Weitere Steuerelemente und ihre erforderlichen Seiten

Hervorgehobener Chat: lass das normale Streaming-Chat-Dock und das Featured-Overlay mit derselben Sitzung verbunden.
Timer: lass die Timer-Seite mit derselben Sitzung verbunden, wenn sie den Timer anzeigen soll.
Warteliste & Gewinnspiel: richte zuerst die Warteliste in Social Stream ein; Zurücksetzen löscht die aktuellen Einträge.

Das Dock verbindet sich nach einem Abbruch der API-Verbindung automatisch neu. Ein grüner Verbunden Status bestätigt nur die Steuerungsverbindung; die Zielseite muss weiterhin geöffnet sein, wenn ein Befehl etwas anzeigen soll.

Direkte API-Beispiele

Dieselben Schaltflächen lassen sich mit HTTP-GET-Anfragen skripten:

https://io.socialstream.ninja/SESSION_ID/creditsStart
https://io.socialstream.ninja/SESSION_ID/creditsPreview
https://io.socialstream.ninja/SESSION_ID/creditsTest
https://io.socialstream.ninja/SESSION_ID/creditsReset

Ersetze SESSION_ID durch die aktive Social-Stream-Sitzung. Siehe Befehle und API oder den vollständigen API-Testbereich für weitere Aktionen.

Fehlerbehebung

Sitzung erforderlich: verwende die genaue Sitzungs-ID aus Social Stream ohne das Wort session=.
Getrennt: confirm Social Stream is active and reopen the generated control link after changing connection settings.
Abspann meldet, dass keine Quelle den Befehl angenommen hat: mache die Abschlussszene sichtbar, warte auf das Laden ihrer Browserquelle und versuche es erneut.
Test funktioniert, aber Start ist leer: Der Test verwendet integrierte Namen. Wähle vor dem Stream die Erfassung im Hintergrund und prüfe, ob normale Chatquellen erfassen.
Featured-Chat-Schaltfläche hat keine sichtbare Wirkung: prüfe, ob Streaming-Chat-Dock und Featured-Overlay dieselbe Sitzung verwenden und geladen sind.