Thermodrucker und Stream-Labels

Was kann gedruckt werden?

Die eigenständige Windows-App kann ohne Druckdialog Aufträge an einen in Windows installierten Drucker senden. Ein Flow kann beliebige verfügbare Werte kombinieren, etwa Zuschauername, Spende, Produkt, Nachricht oder Zählerwert, und Textgröße sowie Ausrichtung steuern.

Kompatibilitätsregel: der Drucker muss als funktionierende Windows-Druckwarteschlange erscheinen. Social Stream druckt über den installierten Windows-Treiber; es sendet keine rohen ESC/POS-, ZPL- oder Hersteller-SDK-Befehle.

Schnelle Einrichtung

1. Verbinde den Drucker per USB, schalte ihn ein und installiere seinen Windows-Treiber. Drucke zuerst eine Windows-Testseite.
2. Öffne in Social Stream Globale Einstellungen und Werkzeuge → Druckersteuerung.
3. Auswählen Drucker suchen und wähle den exakten Warteschlangennamen, den Windows anzeigt.
4. Gib die tatsächliche Papierbreite ein, häufig 58, 80, oder 62 mm, abhängig von Gerät und Material.
5. Lass Feste Etikettenlänge auf 0 für einen Beleg mit inhaltsabhängiger Länge. Gib bei gestanztem Material die Etikettenlänge in Vorschubrichtung in Millimetern ein.
6. Auswählen Ausrichtungstest drucken. Wenn eine Kante fehlt, erhöhe den Sicherheitsrand auf dieser Seite und teste erneut.

Belegrolle, Endlos-Sticker oder gestanztes Etikett?

Dies sind Beispiele, keine garantierte Kompatibilitätsliste. Prüfe vor dem Kauf, ob das genaue Modell einen aktuellen Windows-Treiber hat, deine Etikettenmaße unterstützt und als normaler Windows-Drucker erscheint.

Mit Event Flow ein Spendenetikett drucken

1. Öffne Event-Flow-Editor und erstelle einen Flow.
2. Füge Spende / Trinkgeld Auslöser. Setze Mindestbetrag wenn nur größere Spenden gedruckt werden sollen.
3. Hinzufügen Thermoetikett drucken aus Integrations hinzu und verbinde den Auslöser damit.
4. Setze den Etikettentext auf {username}, füge einen Zeilenumbruch hinzu, dann {donation}. Wähle Schriftgröße, Stärke, Ausrichtung und Kopien.
5. Lasse die Drucker- und Längenüberschreibungen der Aktion normalerweise leer oder auf 0, damit die globalen Printer-Control-Einstellungen gelten.
6. Öffnen Flow testen, gib einen Namen ein, aktiviere Spendenbetrag, gib einen Betrag ein und führe den Test aus. In der eigenständigen App wird dadurch ein echter Druckauftrag gesendet.

Weitere nützliche Platzhalter sind {message}, {source}, {donationAmount}, und {counterValue}. Werte aus vorherigen Knoten können ebenfalls in der Druckvorlage verwendet werden.

Käufer fett, Artikel normal drucken

Wähle Schriftstärke → Ausgewählter Text (**fett**), und gib dann ein:

**{username}**
{subtitle}

Verwende einfache geschweifte Klammern. Neuere Verkaufsintegrationen legen den Produkttitel in subtitle; die Menge kann verfügbar sein als {meta.commerce.quantity}. Wenn dein vorheriger Knoten buyer, verwende **{buyer}** stattdessen. Shopify und eBay lassen die Käuferidentität weg; verwende für diese Quellen daher einen lokalen Bestellzähler oder einen reinen Produktanhänger. Nur Text innerhalb von ** wird fett; eigenes JavaScript oder HTML ist nicht erforderlich. Bestehende Etiketten mit „All bold“ oder „Normal“ behalten ihre Formatierung.

Die Aktion stellt meta.thermalPrintResult.success und optional einen Fehler/Code für spätere Flow-Schritte bereit. Erfolg bedeutet, dass der Auftrag übermittelt wurde, nicht dass Papier ausgegeben wurde. Prüfe bei unklarem Ergebnis die Windows-Warteschlange vor einem erneuten Versuch, um doppelte Etiketten zu vermeiden.

Ein Zähler nummeriert Käufe, nicht einzelne Käufer. Um für jeden Kauf desselben Käufers dieselbe ID zu verwenden, brauchst du eine separate Zuordnung von Käufern zu IDs und ein ausdrückliches Zurücksetzen zu Beginn jedes Streams. Das Feld „reason“ von User Memory ist beschreibender Text, kein spezieller Käufer-ID-Zähler.

Whatnot-Artikeletiketten

Whatnot-Beispielflow herunterladen. Es druckt den Käufer fett, den Artikelnamen und eine Bestell-ID, sofern vorhanden. Eine Zahlungsfehlermeldung druckt ein separates ZAHLUNG FEHLGESCHLAGEN Etikett mit den in dieser Meldung verfügbaren Details.

1. Konfiguriere in der eigenständigen App Druckersteuerung für deinen Drucker und deine Papiergröße und führe den Ausrichtungstest aus.
2. Öffne Event-Flow-Editor, wähle Importieren, und wähle die heruntergeladene JSON-Datei.
3. Auswählen Whatnot: Artikeletiketten und Zahlungswarnungen. Prüfe beide Druckaktionen; sie übernehmen den globalen Drucker und die Etikettenlänge.
4. Aktiviere den Flow und speichere ihn. Lasse deine Whatnot-Quelle mit aktivierter Stream-Ereigniserfassung geöffnet.

Das Beispiel wird deaktiviert importiert. Es verwendet Ereignistyp (erweitert) → Benutzerdefiniertes Ereignis unter product_sold und payment_failed, mit einem Whatnot-Quellfilter. Gebote und Meldungen über endende Auktionen drucken keine Etiketten.

Etiketten fester Länge ohne Überraschungen

Etiketten mit 3 × 1 Zoll (einschließlich einer Munbyn-BT320-Einrichtung): verwende 76,2 mm Breite und 25,4 mm feste Länge, wenn die 1-Zoll-Seite in Vorschubrichtung liegt. Stelle dieses Material und die Ausrichtung auch in den Windows-Druckeinstellungen ein. Beginne mit 12–14 pt Text und teste einen langen Käufer- und Artikelnamen.

Die seitlichen Ränder des Ausrichtungstests markieren die sichere Breite nach der gewählten Druckbereichseinstellung und den Sicherheitsrändern. Die Höhe des Rahmens folgt dem Testtext; er umrahmt nicht das gesamte Etikett und berührt nicht die tatsächlichen Papierkanten.

• In Vorschubrichtung messen. Ein Etikett mit 62 × 29 mm verwendet normalerweise eine Papierbreite von 62 mm und eine feste Etikettenlänge von 29 mm.
• Auch Windows passend einstellen. Wähle in den Druckeinstellungen des Treibers das exakte Etikettenmaterial, die Ausrichtung, Lücken-/Markenerkennung und das Schneideverhalten.
• Fest bedeutet fest. Social Stream fügt einem Auftrag mit fester Länge keinen Belegvorschub hinzu. Zu hoher Inhalt kann je nach Treiber abgeschnitten werden oder überlaufen.
• Teste die längsten realistischen Daten. Lange Zuschauernamen, Produktvarianten, Währungsbezeichnungen und mehrere Zeilen brauchen mehr Platz oder eine kleinere Schrift.
• Treibergrenzen gelten weiterhin. Windows oder der Druckertreiber können sehr kurze benutzerdefinierte Seiten begrenzen; Social Stream fordert mindestens 20 mm an.

Stream-Ideen

• Drucke Sticker mit Unterstützernamen für eine Wand, Requisite, Karte oder physische Fortschrittstafel.
• Erstelle bei eingehenden Käufen Anhänger für Merch-Bestellungen, Auftragsarbeiten, Getränke oder Abholung.
• Drucke Lose oder Teilnahmescheine mit Ratenbegrenzung und Teilnahmeprüfung vor der Druckaktion.
• Erstelle VIP-Ausweise, Teamzuordnungen, Challenge-Marken oder Etiketten für Spendenmeilensteine.
• Drucke eine kurze Moderations- oder Abwicklungswarteschlange für einen Produzenten neben dem Streamer.

Häufige Lösungen

• Kein Drucker erscheint: prüfe, ob Windows eine Testseite drucken kann, starte dann Social Stream neu und wähle erneut „Find printers“.
• Der Auftrag meldet Erfolg, aber nichts wird gedruckt: öffne die Windows-Warteschlange dieses Druckers und prüfe auf Pause, Offline-Status, Papier-, Treiber- oder Anschlussfehler.
• Eine Kante wird abgeschnitten: lasse „Use printable area“ aktiviert und erhöhe den Sicherheitsrand auf dieser Seite.
• Zu viel leeres Papier: verwende für Belege die feste Länge 0, reduziere unteren Rand und Vorschub oder stelle die exakte Länge für Etikettenmaterial ein.
• Aus einem Etikett werden zwei: der Inhalt ist höher als das feste Etikett, oder Windows verwendet die falsche Materialgröße. Reduziere Text, Schriftgröße, Zeilenabstand und Ränder.
• „Test Flow“ verwendet den falschen Drucker: wähle im Knoten „Print Thermal Label“ einen anderen Drucker. Eine leere Überschreibung verwendet beim direkten Test im Editor den Windows-Standarddrucker.