Entwerfen Sie benutzerdefinierte Commerce-Overlays

Wählen Sie die richtige Startseite

Verwende monetization.html für das aktuelle Publikumsprodukt-/Support-Overlay und commerce-board.html für Boards und Ansichten verkaufter Artikel. Die Dokumentations-Setup-Seiten und shop.html Schaufenster erfüllen unterschiedliche Rollen; Eine Storefront ist kein OBS-Bedienfeld.

Laden Sie die Dateistruktur herunter und behalten Sie sie bei

1. Laden Sie die Quell-ZIP-Datei herunter und extrahieren Sie es. Diese Anleitungen verwenden die Beta-Quelle; Bewahren Sie die Dateien eines Downloads zusammen auf.
2. Kopieren monetization.html auf my-products.html neben dem Original. Wenn Sie eine andere Seite oder ein anderes Thema auswählen, bewahren Sie die Kopie im Originalordner dieser Datei auf.
3. Öffnen Sie den kopierten HTML-Code und das referenzierte CSS/JS in Ihrem Editor oder KI-Tool. Fügen Sie die bereitgestellten Grafiken/Schriftarten demselben Projekt hinzu und verwenden Sie relative Pfade. Beginnen Sie mit CSS-Überschreibungen; Beziehen Sie den Renderer ein, wenn Sie das generierte Markup ändern.

Die folgenden Dateien helfen Ihnen bei der Suche nach Design und Verhalten. Dies ist eine Leseliste, kein vollständiges Abhängigkeitspaket: Behalten Sie den extrahierten Ordner bei, einschließlich Bildern, Schriftarten, Skripten und allen Datendateien.

Verbinden Sie Ihre Kopie und öffnen Sie sie in OBS

Starten Sie SSN und sorgen Sie dafür, dass zunächst die ursprünglich generierte Overlay-URL funktioniert. Die session= value stellt eine Verbindung zu dieser SSN-Sitzung her; Es ist nicht Ihr Kanalname oder der Name dieser Datei. Halten Sie SSN, die relevante Funktion und ihre Datenquellen am Laufen.

1. Ziehen Sie Ihre bearbeitete HTML-Datei in Chrome oder Edge. Kopieren Sie die Adresse aus der Adressleiste. es beginnt mit file:///.
2. Alles kopieren von ? weiter in Ihrem funktionierenden SSN-Overlay-Link und fügen Sie ihn am Ende dieser Dateiadresse hinzu. Behalten Sie alle Einstellungen bei, einschließlich Sitzung, Passwort usw # Ende.
3. Öffnen Sie das Ergebnis in einem Browser und legen Sie dann eine OBS-Browserquelle fest URL an die gleiche Adresse mit Lokale Datei ungeprüft. Passen Sie die Quellabmessungen an Ihr beabsichtigtes Design an.

Für die obige Startdatei sieht die lokale Adresse wie folgt aus; Ihr tatsächlicher Link kann zusätzliche erforderliche Optionen enthalten:

file:///C:/SSN/social_stream-beta/my-products.html?session=YOUR_SESSION

Verwenden Sie die tatsächliche Dateiadresse auf Ihrem Computer. OBS speichert es mit der Quelle; Bewahren Sie den heruntergeladenen Ordner am selben Ort auf. Aktualisieren Sie nach dem Speichern der Designänderungen die Browserquelle. Die Gemeinsame Einrichtungsanleitung enthält Mac-Beispiele und einen optionalen Launcher für das Kontrollkästchen „Lokale Datei“.

Wo kann das Design geändert werden?

Ändern Sie das Kartenlayout, die Typografie, den Produktbildrahmen, die Preisgestaltung, die QR-Platzierung und die Boardkacheln. Halten Sie QR-Codes groß und klar genug, um sie scannen zu können. Einbeziehen thirdparty/qrcode.min.js, Übersetzungsskripte und der vollständige freigegebene Commerce-Ordner, der von der von Ihnen ausgewählten Seite geladen wird.

Wiederverwendung des Handelsstatus und der Steuerelemente, die bereits von den Docks SSN, Stream Deck, Event Flow und den optionalen OBS-Docks verwendet werden. Ausgewählten/verborgenen/geplanten Status beibehalten. Halten Sie Sitzungsdetails, Einrichtungsmeldungen, Anmeldeinformationen für Veröffentlichungen und Bedienelemente von der Zielgruppengrafik fern. Ein erfolgreiches Update stellt nicht fest, ob OBS live ist oder diese Quelle anzeigt.

Kopieren Sie diese KI-Eingabeaufforderung

Geben Sie der KI Ihre kopierten Quelldateien und Referenzvorlagen. Ersetzen Sie die Angaben in Klammern. Behalten Sie die Hinweise zur Eingabesicherheit in der Eingabeaufforderung bei.

Customize my-products.html, copied from monetization.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].

Restyle [monetization.html / commerce-board.html] as [design]. Preserve the shared commerce state/control API, product selection, visibility/scheduling, prices, destinations, QR behavior, and stale/empty states. Keep configuration and credentials out of the audience display. Do not create a second local product catalog or infer OBS visibility from a received command.

Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.

Testen Sie diesen Overlay-Typ

Verwenden Sie zunächst eine Vorschau oder ein Test-Setup. Die Anleitung für Testnachrichten erklärt, wie man fiktive Nutzlasten über SSN sendet; Ein an Ihre Produktionssitzung übermittelter Test kann die vorhandenen Automatisierungen auslösen.

1. Verwenden Sie für Boards commerce-board.html?demo, um fiktive Daten zu überprüfen. Demo für ein angeschlossenes Display entfernen.
2. Verwenden Sie die vorhandenen Produkt-/Board-Steuerelemente, um Elemente auszuwählen, auszublenden und zu ändern. Überprüfen Sie lange Titel, fehlende Bilder, Preisformatierungen und QR-Scans in einer Vorschau im OBS-Format.
3. Überprüfen Sie den leeren und getrennten Zustand und führen Sie ein Neuladen durch. Testen Sie das konfigurierte öffentliche Produktziel, ohne einen neuen Katalog zu veröffentlichen, nur um den Stil des Overlays zu ändern.

Führen Sie außerdem die aus Eingabe-Rendering-Prüfungen gegen die Renderpfade, die Sie geändert haben. Aktualisieren Sie nach dem Speichern der Änderungen die OBS-Browserquelle zwischen den Proben und wiederholen Sie die sichtbare Interaktion. Durch Browservorschauen wird keine Live-Aufnahme oder kein OBS-Verhalten festgestellt.

Weitere Informationen: Commerce-Setup · Gemeinsame Produktkontrollen · Boards und Verkäufe · Ereignisreferenz · Fehlerbehebung bei der lokalen Einrichtung.