Live-Produkte und Zuschauerlinks

1. Produkt oder Unterstützungslink hinzufügen

Öffne Monetization > Products & support links > Set up products and links. Füge einen öffentlichen HTTPS-Link ein und wähle Details aus Link laden. Der Schnellimport unterstützt öffentliche Gumroad-, itch.io-, Ko-fi-, Buy-Me-a-Coffee- und Fourthwall-Seiten. Eigene Domains, Weiterleitungen, private Seiten und Seiten ohne öffentliche Metadaten können manuelle Eingabe erfordern. Die bestehenden Shopify- und Fourthwall-API-Importoptionen bleiben verfügbar.

Prüfe Titel, Bild, Preis, Währung und Zweck. Der Schnellimport lässt den Preis bewusst leer. Wähle Produkt oder Link hinzufügen, aktiviere „Products & support links“, dann Einrichtung speichern. Für manuelle Karten ist kein Händlerkonto nötig.

Shop, Gift, Support und Join beschreiben den Zweck des Links. Sie ändern nicht die Klassifizierung späterer Zahlungsereignisse. Karten sind gespeicherte Momentaufnahmen; maßgeblich für Bestand und Preise ist die Kaufabwicklung.

2. Steuern, was erscheint

Füge die bestehende Overlay-URL für Products & support links zu OBS hinzu. Verwende Showcase oder Support card für Werbung oder Both, um Aktivitätsmeldungen einzuschließen.

• Jetzt anzeigen bei einer gespeicherten Zeile zeigt dieses Produkt fest an und überschreibt den regelmäßigen Kartenzeitplan.
• Nächstes Produkt zeigt das nächste gespeicherte Produkt fest an.
• Produkte ausblenden blendet Werbekarten aus. Kauf- und Geschenkmeldungen laufen weiter.
• Zeitplan fortsetzen stellt die gespeicherten Einstellungen für erstes Produkt oder Rotation wieder her.

Lege Show/hide seconds vor der Bedienung fest. Null gilt bis zur nächsten Änderung; 1–3600 stellt nach dieser Anzahl Sekunden den gespeicherten Zeitplan wieder her. Live-Überschreibungen werden beim Neustart von SSN zurückgesetzt. Ungespeicherte Zeilen sind markiert, und ihre Show-now-Schaltflächen bleiben bis Save setup deaktiviert. Der Status nennt das ausgewählte Produkt und die verbleibenden Sekunden; er behauptet weder, dass OBS live ist, noch dass diese Quelle sichtbar ist. Steuerelemente identifizieren ein Produkt anhand seiner exakt gespeicherten URL, sodass das Verschieben in der Liste keine Automatisierung beschädigt.

3. Einen Zuschauerlink veröffentlichen

Öffne Display options > Public viewer page und wähle Gespeicherte Links veröffentlichen. Dies veröffentlicht ausdrücklich alle gespeicherten Produkt-/Unterstützungslinks einschließlich Titel, Bilder, Preise und Zwecke. Teile Zuschauerlink kopieren mit deinen Zuschauern. Produkt-QR-Codes verwenden jetzt diese beständige Seite, sodass ein Zuschauer ein Produkt auch nach einem Wechsel im Overlay noch finden kann.

Gespeicherte Änderungen und Live-Steuerung aktualisieren dieselbe URL. Die Zuschauerseite prüft alle 15 Sekunden auf Änderungen und kennzeichnet das hervorgehobene Produkt. Andere Links bleiben zugänglich, wenn Werbekarten ausgeblendet sind. Der zuletzt veröffentlichte Katalog bleibt verfügbar, während SSN offline ist; der gespeicherte Zeitstempel wird angezeigt, und „hervorgehoben“ bedeutet die zuletzt gespeicherte Auswahl oder Rotation, nicht den Nachweis, dass der Creator live ist.

Veröffentlichung aufheben entfernt die Seite; Produkt-QR-Codes führen wieder zu einzelnen Produktlinks. Offene Zuschauerseiten leeren sich bei der nächsten erfolgreichen Prüfung. Bereits geteilte URLs laden nicht mehr, bis du erneut veröffentlichst. Erneutes Veröffentlichen vom selben Gerät stellt dieselbe URL wieder her. Bewahre das SSN-Geräteprofil: Sein privater Veröffentlichungsschlüssel wird zum Aktualisieren oder Entfernen der Seite benötigt.

Wenn die API nicht verfügbar ist, funktionieren lokale Steuerelemente weiterhin. Fehlgeschlagene Aktualisierungen lassen die zuletzt veröffentlichte Seite sichtbar und werden wiederholt, solange SSN geöffnet ist. Das Popup meldet den Fehler. Veröffentlichung setzt voraus, dass der optionale Public-Shop-Dienst bereitgestellt wurde; kein Shop- oder Zahlungskonto ist beteiligt.

Event Flow und Fernsteuerung

Füge in Event Flow die Produkte & Unterstützung Aktion aus der Gruppe der Overlay-Aktionen hinzu. Wähle Show, Next, Hide oder Resume; lege optional die genaue gespeicherte Produkt-URL und Sekunden fest. Verwende einen passenden vorhandenen Auslöser, etwa deinen eigenen Moderatorenbefehl, statt jeder Chatnachricht Produktänderungen zu erlauben.

Füge im Stream-Deck-Plugin Preset-Command-Tasten aus Produkte & Unterstützung: Show product, Next product, Hide products und Resume products. Show enthält eine Auswahl gespeicherter Produkte; wähle Refresh products and state, um die Liste zu laden. Eine nicht verfügbare gespeicherte Auswahl bleibt sichtbar, statt sich stillschweigend zu ändern. Du kannst weiterhin die öffentliche Produkt-URL einfügen oder sie für das aktuelle/erste Produkt leer lassen. Next und Hide akzeptieren optional Sekunden. Die Tasten warten unabhängig von Aktualisierungen der öffentlichen Seite auf SSNs Bestätigung der lokalen Änderung. Füge die optionale Taste Product State hinzu, um Rückmeldung zu Auswahl/Ausblendung/Zeitplan zu erhalten, die alle fünf Sekunden aktualisiert wird, solange die Taste sichtbar ist. Inspector und SSN zeigen den vollständigen Produktnamen; die kleine Zustandstaste kürzt lange Namen. Verwende die bestehende P2P- oder WebSocket-Verbindung.

Die bestehende authentifizierte Sitzungs-Fernsteuerungs-API akzeptiert dieselbe Steuerung:

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

Befehle sind show, next, hide und resume. Lasse die URL weg, um das aktuelle/erste Produkt anzuzeigen. Host-Steuerung muss aktiviert sein. Teile niemals eine private Sitzungs-/Steuerungs-URL mit Zuschauern; verwende den veröffentlichten Zuschauerlink.

Diese Aktionen senden nur den bestehenden monetization_update Anzeigezustand. Sie erzeugen weder Spenden, Käufe, Chatbeiträge noch Event-Flow-Zahlungsauslöser. Bestehendes hasDonation Verhalten bleibt unverändert.

Wissen, wann eine Steuerungsaktion abgeschlossen ist

Die Products-&-Support-Aktion wartet auf SSNs Antwort, bevor der Flow fortgesetzt wird. Bei normalen Ereignisnutzdaten meta.commerceControlResult enthält success und entweder den resultierenden commerce Steuerungszustand oder einen error. Ein Fehler stoppt spätere Aktionen in dieser Kette; der ursprüngliche Kauf oder das Trinkgeld bleibt anderen Flows und Overlays verfügbar. Der Zustand bestätigt SSNs Auswahl, Ausblendung oder Zeitplan; die OBS-Sichtbarkeit ist davon getrennt.

Wenn innerhalb von acht Sekunden keine Antwort kommt, meldet die Aktion eine Zeitüberschreitung. Die Steuerung kann dennoch angewendet worden sein: Prüfe den Popup- oder Dock-Zustand, bevor du Next erneut versuchst. Externe Fernsteuerungsclients sollten das bestehende Anfrage-/Antwortprotokoll verwenden und das zurückgegebene Ergebnis prüfen, statt einen gesendeten Befehl als Erfolg zu behandeln.

Andere Effekte haben eigene Rückmeldungen. Print Thermal Label meldet meta.thermalPrintResult; eine erfolgreiche Auftragsübermittlung bestätigt keine Papierausgabe. Eine synchrone Webhook-Aktion kann HTTP-Status und Antwort zurückgeben und bei Fehlern blockieren. Dies sind Aktionsergebnisse, keine neuen Zahlungsereignisse. Siehe die Ereignisreferenz zum Vertrag für Steuerungsergebnisse.