Stampanti termiche ed etichette per la diretta

Cosa può stampare?

L'app autonoma per Windows può inviare lavori senza finestre di dialogo a una stampante installata in Windows. Un flusso può combinare qualunque valore disponibile, come nome dello spettatore, donazione, prodotto, messaggio o valore di contatore, e controllare dimensione e allineamento del testo.

Regola di compatibilità: la stampante deve comparire come coda di stampa Windows funzionante. Social Stream stampa tramite il driver Windows installato; non invia comandi ESC/POS, ZPL o SDK del produttore grezzi.

Configurazione rapida

1. Collega la stampante via USB, accendila e installa il driver Windows. Stampa prima una pagina di prova da Windows.
2. In Social Stream, apri Impostazioni globali e strumenti → Controllo stampante (Printer Control).
3. Seleziona Trova stampanti (Find printers) e scegli il nome esatto della coda mostrato da Windows.
4. Inserisci la larghezza fisica della carta, comunemente 58, 80, oppure 62 mm a seconda del dispositivo e del supporto.
5. Lascia Lunghezza fissa dell'etichetta a 0 per una ricevuta dimensionata in base al contenuto. Per un supporto pretagliato, inserisci in millimetri la lunghezza dell'etichetta nella direzione di avanzamento.
6. Seleziona Stampa test di allineamento. Se manca un bordo, aumenta il margine di sicurezza su quel lato e riprova.

Rotolo per ricevute, adesivo continuo o etichetta pretagliata?

Sono esempi, non un elenco di compatibilità garantita. Prima dell'acquisto, verifica che il modello esatto abbia un driver Windows attuale, supporti le dimensioni delle tue etichette e compaia come una normale stampante Windows.

Stampare un'etichetta di donazione con Event Flow

1. Apri Editor Event Flow e crea un flusso.
2. Aggiungi il trigger Donazione / Mancia (Donation / Tip) . Imposta Importo minimo (Minimum Amount) se devono essere stampate solo le donazioni più grandi.
3. Aggiungi Stampa etichetta termica (Print Thermal Label) da Integrations e collega il trigger all'azione.
4. Imposta il testo dell'etichetta su {username}, aggiungi una nuova riga, poi {donation}. Scegli dimensione, peso, allineamento del testo e numero di copie.
5. Normalmente lascia vuoti o a 0 i valori specifici di stampante e lunghezza fissa dell'azione, così si applicano le impostazioni globali di Printer Control.
6. Apri Prova flusso (Test Flow), inserisci un nome, attiva Contiene donazione (Has Donation), inserisci un importo ed esegui il test. Questo invia un vero lavoro di stampa nell'app autonoma.

Altri segnaposto utili includono {message}, {source}, {donationAmount}, e {counterValue}. Nel modello di stampa puoi usare anche i valori creati dai nodi precedenti.

Acquirente in grassetto, articolo in testo normale

Scegli Peso → Testo selezionato (**grassetto**) (Weight → Selected text (**bold**)), poi inserisci:

**{username}**
{subtitle}

Usa parentesi graffe singole. Le integrazioni commerciali recenti inseriscono il titolo del prodotto in subtitle; la quantità può essere disponibile come {meta.commerce.quantity}. Se il nodo precedente crea buyer, usa **{buyer}** al suo posto. Shopify ed eBay omettono l'identità dell'acquirente: per queste sorgenti usa un contatore locale degli ordini o un'etichetta con il solo prodotto. Solo il testo racchiuso in ** diventa in grassetto; non servono JavaScript o HTML personalizzati. Le etichette esistenti All bold e Normal conservano la loro formattazione.

L'azione espone meta.thermalPrintResult.success e un eventuale errore/codice per i passaggi successivi del flusso. Il successo indica che il lavoro è stato inviato, non che la carta sia uscita. Controlla la coda Windows prima di ripetere un lavoro dall'esito incerto per evitare etichette duplicate.

Un contatore numera gli acquisti, non gli acquirenti unici. Riutilizzare lo stesso ID per tutti gli acquisti dello stesso acquirente richiede una mappatura separata acquirente-ID e un azzeramento esplicito all'inizio di ogni diretta. Il campo reason di User Memory è testo descrittivo, non un contatore dedicato agli ID acquirente.

Etichette articoli Whatnot

Scarica il flusso di esempio Whatnot. Stampa l'acquirente in grassetto, il nome dell'articolo e un ID ordine, quando fornito. Una notifica di pagamento non riuscito stampa un'etichetta separata PAGAMENTO NON RIUSCITO con i dettagli disponibili in quella notifica.

1. Nell'app autonoma, configura Controllo stampante (Printer Control) per la tua stampante e le dimensioni della carta, ed esegui il relativo test di allineamento.
2. Apri Editor Event Flow, scegli Importa (Import), e seleziona il file JSON scaricato.
3. Seleziona Whatnot: etichette articoli + avvisi di pagamento. Controlla entrambe le azioni di stampa; ereditano la stampante e la lunghezza dell'etichetta globali.
4. Attiva il flusso e salvalo. Mantieni aperta la sorgente Whatnot con l'acquisizione degli eventi della diretta attivata.

L'esempio viene importato disattivato. Usa Tipo di evento (avanzato) → Evento personalizzato (Event Type (Advanced) → Custom Event) per product_sold e payment_failed, con un filtro della sorgente Whatnot. Le offerte e le notifiche di fine asta non stampano etichette.

Etichette a lunghezza fissa senza sorprese

Etichette da 3 × 1 pollice (inclusa una configurazione Munbyn BT320): usa una larghezza di 76,2 mm e una lunghezza fissa di 25,4 mm quando il lato da 1 pollice è nella direzione di avanzamento. Imposta lo stesso supporto e orientamento nelle Preferenze stampa di Windows. Parti da testo di 12–14 pt e prova nomi lunghi di acquirente e articolo.

I bordi laterali del test di allineamento indicano la larghezza sicura dopo l'applicazione dell'impostazione dell'area stampabile e dei margini di sicurezza selezionati. L'altezza del riquadro segue il testo di prova; non delinea l'intera etichetta e non tocca i bordi fisici della carta.

• Misura nella direzione di avanzamento. Un'etichetta da 62 × 29 mm usa normalmente una larghezza carta di 62 mm e una lunghezza etichetta fissa di 29 mm.
• Fai corrispondere anche Windows. Seleziona il supporto etichette esatto, l'orientamento, il rilevamento di spazi/segni e il comportamento della taglierina nelle Preferenze stampa del driver.
• Fissa significa fissa. Social Stream non aggiunge spazio di avanzamento per ricevute a un lavoro a lunghezza fissa. Un contenuto troppo alto può essere tagliato o proseguire oltre, a seconda del driver.
• Prova i dati realistici più lunghi. Nomi lunghi degli spettatori, varianti dei prodotti, indicazioni di valuta e più righe richiedono più spazio o un carattere più piccolo.
• Si applicano comunque i limiti del driver. Windows o il driver della stampante potrebbero limitare le pagine personalizzate molto corte; Social Stream richiede un minimo di 20 mm.

Idee per la diretta

• Stampa adesivi con i nomi dei sostenitori per una parete, un oggetto di scena, una mappa o un tabellone fisico dei progressi.
• Crea etichette per ordini di merchandising, commissioni, bevande o ritiri quando arrivano gli acquisti.
• Stampa biglietti della lotteria o tagliandi di partecipazione ai giveaway, con limiti di frequenza e verifiche di idoneità prima dell'azione di stampa.
• Crea badge VIP, assegnazioni di squadra, gettoni per sfide o etichette per traguardi di donazione.
• Stampa una breve coda di moderazione o evasione ordini per un assistente che lavora accanto allo streamer.

Soluzioni ai problemi comuni

• Non compare alcuna stampante: verifica che Windows possa stampare una pagina di prova, poi riavvia Social Stream e seleziona nuovamente Find printers.
• Il lavoro risulta riuscito, ma non viene stampato nulla: apri la coda Windows della stampante e controlla la presenza di pause, stato offline, errori di carta, driver o porta.
• Un bordo viene tagliato: mantieni attivo Use printable area e aumenta il margine di sicurezza su quel lato.
• C'è troppa carta bianca: usa la lunghezza fissa 0 per le ricevute, riduci margine inferiore e avanzamento oppure imposta la lunghezza esatta del supporto per etichette.
• Un'etichetta diventa due: il contenuto è più alto dell'etichetta fissa, oppure Windows usa una dimensione del supporto errata. Riduci testo, dimensione del carattere, interlinea e margini.
• Test Flow usa la stampante sbagliata: scegli una stampante specifica nel nodo Print Thermal Label. Un valore vuoto usa la stampante predefinita di Windows quando esegui il test direttamente nell'editor.