Drukarki termiczne i etykiety transmisji

Co można wydrukować?

Samodzielna aplikacja Windows może wysyłać zadania bez okna dialogowego do drukarki zainstalowanej w Windows. Przepływ może łączyć dowolne dostępne wartości, takie jak nazwa widza, wpłata, produkt, wiadomość lub wartość licznika, oraz sterować rozmiarem tekstu i wyrównaniem.

Zasada zgodności: drukarka musi pojawiać się jako działająca kolejka drukarki Windows. Social Stream drukuje przez zainstalowany sterownik Windows; nie wysyła surowych poleceń ESC/POS, ZPL ani SDK producenta.

Szybka konfiguracja

1. Podłącz drukarkę przez USB, włącz ją i zainstaluj sterownik Windows. Najpierw wydrukuj stronę testową Windows.
2. W Social Stream otwórz Ustawienia globalne i narzędzia → Sterowanie drukarką (Printer Control).
3. Wybierz Znajdź drukarki (Find printers) i wybierz dokładną nazwę kolejki pokazywaną przez Windows.
4. Wpisz fizyczną szerokość papieru, zwykle 58, 80 lub 62 mm, zależnie od urządzenia i nośnika.
5. Pozostaw Stała długość etykiety (Fixed label length) na 0 dla paragonu o rozmiarze dopasowanym do treści. Dla nośnika z etykietami wykrawanymi wpisz długość etykiety w kierunku podawania w milimetrach.
6. Wybierz Drukuj test wyrównania (Print alignment test). Jeśli brakuje krawędzi, zwiększ bezpieczny margines po tej stronie i przetestuj ponownie.

Rolka paragonowa, ciągła naklejka czy etykieta wykrawana?

To przykłady, a nie gwarantowana lista zgodności. Przed zakupem potwierdź, że konkretny model ma aktualny sterownik Windows, obsługuje wymiary Twoich etykiet i pojawia się jako zwykła drukarka Windows.

Wydrukuj etykietę wpłaty za pomocą Event Flow

1. Otwórz Edytor Event Flow i utwórz przepływ.
2. Dodaj Wpłata / napiwek (Donation / Tip) wyzwalacz. Ustaw Minimalna kwota (Minimum Amount) , jeśli mają się drukować tylko większe wpłaty.
3. Dodaj Drukuj etykietę termiczną (Print Thermal Label) z Integrations i połącz z nim wyzwalacz.
4. Ustaw tekst etykiety na {username}, dodaj nowy wiersz, a następnie {donation}. Wybierz rozmiar czcionki, grubość, wyrównanie i liczbę kopii.
5. Zwykle pozostaw nadpisanie drukarki i stałej długości w akcji puste lub równe 0, aby obowiązywały globalne ustawienia Printer Control.
6. Otwórz Testuj przepływ (Test Flow), wpisz nazwę, włącz Kwota wsparcia (Has Donation), wpisz kwotę i uruchom test. Wysyła to rzeczywiste zadanie drukowania w samodzielnej aplikacji.

Inne przydatne znaczniki obejmują {message}, {source}, {donationAmount} i {counterValue}. W szablonie wydruku można też używać wartości utworzonych przez wcześniejsze węzły.

Pogrub kupującego, pozostaw zwykłą nazwę przedmiotu

Wybierz Weight → Selected text (**bold**), a następnie wpisz:

**{username}**
{subtitle}

Używaj pojedynczych nawiasów klamrowych. Nowsze integracje handlowe umieszczają tytuł produktu w subtitle; ilość może być dostępna jako {meta.commerce.quantity}. Jeśli wcześniejszy węzeł tworzy buyer, użyj **{buyer}** zamiast tego. Shopify i eBay pomijają tożsamość kupującego, więc dla tych źródeł użyj lokalnego licznika zamówień lub etykiety samego produktu. Tylko tekst otoczony ** zostaje pogrubiony; nie jest potrzebny własny JavaScript ani HTML. Istniejące etykiety All bold i Normal zachowują formatowanie.

Akcja udostępnia meta.thermalPrintResult.success oraz opcjonalny błąd/kod dla kolejnych kroków przepływu. Powodzenie oznacza przesłanie zadania, a nie wyjście papieru. Przed ponowieniem zadania o niepewnym wyniku sprawdź kolejkę Windows, aby uniknąć podwójnych etykiet.

Counter numeruje zakupy, a nie unikalnych kupujących. Ponowne używanie jednego identyfikatora dla każdego zakupu tej samej osoby wymaga osobnego mapowania kupujący–identyfikator i jawnego resetu na początku każdej transmisji. Pole powodu w User Memory jest tekstem opisowym, a nie dedykowanym licznikiem identyfikatorów kupujących.

Etykiety przedmiotów Whatnot

Pobierz przykładowy przepływ Whatnot. Drukuje kupującego pogrubioną czcionką, nazwę przedmiotu i identyfikator zamówienia, jeśli został podany. Powiadomienie o nieudanej płatności drukuje oddzielną etykietę PŁATNOŚĆ NIEUDANA z danymi dostępnymi w tym powiadomieniu.

1. W samodzielnej aplikacji skonfiguruj Sterowanie drukarką (Printer Control) dla swojej drukarki i rozmiaru papieru oraz uruchom test wyrównania.
2. Otwórz Edytor Event Flow, wybierz Importuj (Import)i wybierz pobrany plik JSON.
3. Wybierz Whatnot: etykiety przedmiotów i ostrzeżenia o płatnościach. Sprawdź obie akcje drukowania; dziedziczą globalną drukarkę i długość etykiety.
4. Włącz przepływ i zapisz go. Pozostaw źródło Whatnot otwarte z włączonym przechwytywaniem zdarzeń transmisji.

Przykład importuje się jako wyłączony. Używa Event Type (Advanced) → Custom Event dla product_sold i payment_failed, z filtrem źródła Whatnot. Oferty i powiadomienia o końcu aukcji nie drukują etykiet.

Etykiety o stałej długości bez niespodzianek

Etykiety 3 × 1 cala (w tym konfiguracja Munbyn BT320): użyj szerokości 76.2 mm i stałej długości 25.4 mm, gdy bok 1-calowy jest kierunkiem podawania. Dopasuj nośnik i orientację w preferencjach drukowania Windows. Zacznij od tekstu 12–14 pt i przetestuj długą nazwę kupującego oraz przedmiotu.

Boczne ramki testu wyrównania oznaczają bezpieczną szerokość po zastosowaniu wybranego ustawienia obszaru drukowania i bezpiecznych marginesów. Wysokość ramki wynika z tekstu testowego; nie obrysowuje całej etykiety ani nie dotyka fizycznych krawędzi papieru.

• Mierz w kierunku podawania papieru. Etykieta 62 × 29 mm zwykle używa szerokości papieru 62 mm i stałej długości etykiety 29 mm.
• Dopasuj również ustawienia Windows. W preferencjach drukowania sterownika wybierz dokładny nośnik etykiet, orientację, wykrywanie przerw/znaczników i działanie obcinaka.
• Stała długość pozostaje stała. Social Stream nie dodaje odstępu wysuwu paragonu do zadania o stałej długości. Zbyt wysoka treść może zostać obcięta lub przeniesiona dalej, zależnie od sterownika.
• Przetestuj najdłuższe realistyczne dane. Długie nazwy widzów, warianty produktów, oznaczenia walut i wiele wierszy wymagają więcej miejsca lub mniejszej czcionki.
• Ograniczenia sterownika nadal obowiązują. Windows lub sterownik drukarki mogą ograniczać bardzo krótkie strony niestandardowe; Social Stream żąda minimum 20 mm.

Pomysły na transmisję

• Drukuj naklejki z nazwami wspierających na ścianę, rekwizyt, mapę lub fizyczną tablicę postępu.
• Twórz etykiety zamówień gadżetów, zleceń, napojów lub odbioru w miarę napływania zakupów.
• Drukuj losy lub potwierdzenia udziału w losowaniu, z limitami częstotliwości i sprawdzeniem uprawnień przed akcją drukowania.
• Twórz identyfikatory VIP, przydziały drużyn, żetony wyzwań lub etykiety progów wpłat.
• Wydrukuj krótką kolejkę moderacji lub realizacji dla producenta pracującego obok streamera.

Typowe rozwiązania

• Nie pojawia się żadna drukarka: potwierdź, że Windows może wydrukować stronę testową, a następnie uruchom ponownie Social Stream i ponownie wybierz Find printers.
• Zadanie zgłasza powodzenie, ale nic się nie drukuje: otwórz kolejkę Windows tej drukarki i sprawdź wstrzymanie, tryb offline, brak papieru oraz błędy sterownika lub portu.
• Krawędź jest obcięta: pozostaw Use printable area włączone i zwiększ bezpieczny margines po tej stronie.
• Jest zbyt dużo pustego papieru: użyj stałej długości 0 dla paragonów, zmniejsz dolny margines i wysuw lub ustaw dokładną długość nośnika etykiet.
• Jedna etykieta zamienia się w dwie: treść jest wyższa niż stała etykieta lub Windows używa niewłaściwego rozmiaru nośnika. Zmniejsz ilość tekstu, rozmiar czcionki, odstępy między wierszami i marginesy.
• Test Flow używa niewłaściwej drukarki: wybierz nadpisanie drukarki w węźle Print Thermal Label. Puste nadpisanie podczas bezpośredniego testowania w edytorze używa domyślnej drukarki Windows.