Impressoras térmicas e etiquetas de transmissão

O que pode imprimir?

O aplicativo independente para Windows pode enviar trabalhos silenciosos a uma impressora instalada no Windows. Um fluxo pode combinar qualquer valor disponível, como nome de espectador, doação, produto, mensagem ou valor de contador, e controlar tamanho e alinhamento do texto.

Regra de compatibilidade: a impressora deve aparecer como uma fila funcional do Windows. O Social Stream imprime pelo driver instalado no Windows; não envia comandos brutos ESC/POS, ZPL nem de SDK do fabricante.

Configuração rápida

1. Conecte a impressora por USB, ligue-a e instale o driver do Windows. Primeiro, imprima uma página de teste do Windows.
2. No Social Stream, abra Configurações e ferramentas globais → Controle da impressora.
3. Selecione Encontrar impressoras e escolha o nome exato da fila mostrado pelo Windows.
4. Insira a largura física do papel, normalmente 58, 80, ou 62 mm, dependendo do dispositivo e do papel.
5. Deixe Comprimento fixo da etiqueta em 0 para um recibo ajustado ao conteúdo. Para papel pré-cortado, insira o comprimento da etiqueta no sentido de avanço, em milímetros.
6. Selecione Imprimir teste de alinhamento. Se faltar uma borda, aumente a margem de segurança desse lado e teste novamente.

Rolo de recibo, adesivo contínuo ou etiqueta pré-cortada?

Estes são exemplos, não uma lista de compatibilidade garantida. Antes de comprar, confirme que o modelo exato tem um driver atual para Windows, aceita as dimensões da etiqueta e aparece como uma impressora normal do Windows.

Imprimir uma etiqueta de doação com Event Flow

1. Abra: Editor do Event Flow e crie um fluxo.
2. Adicione o Doação / Gorjeta gatilho. Defina Valor mínimo se apenas doações maiores devem imprimir.
3. Adicione Imprimir etiqueta térmica em Integrações e conecte o gatilho a ele.
4. Defina o texto da etiqueta como {username}, adicione uma nova linha e depois {donation}. Escolha tamanho da fonte, peso, alinhamento e cópias.
5. Normalmente, deixe as substituições de impressora e comprimento fixo da ação em branco ou 0 para aplicar as configurações globais de Controle da impressora.
6. Abrir Testar fluxo, digite um nome, ative Tem doação (Has Donation), insira um valor e execute o teste. Isso envia um trabalho real de impressão no aplicativo independente.

Outros placeholders úteis incluem {message}, {source}, {donationAmount}, e {counterValue}. Valores criados por nós anteriores também podem ser usados no modelo de impressão.

Comprador em negrito, item normal

Escolha Peso → Texto selecionado (**negrito**), depois digite:

**{username}**
{subtitle}

Use chaves simples. Integrações recentes de comércio colocam o título do produto em subtitle; a quantidade pode estar disponível como {meta.commerce.quantity}. Se o nó anterior criar buyer, use **{buyer}** em seu lugar. Shopify e eBay omitem a identidade do comprador, então use um contador local de pedidos ou uma etiqueta somente de produto para essas fontes. Somente o texto envolvido em ** fica em negrito; não é necessário JavaScript nem HTML personalizado. Etiquetas existentes em Tudo em negrito e Normal mantêm a formatação.

A ação disponibiliza meta.thermalPrintResult.success e um erro/código opcional para etapas posteriores do fluxo. Sucesso significa que o trabalho foi enviado, não que saiu papel. Verifique a fila do Windows antes de tentar novamente um trabalho incerto para evitar etiquetas duplicadas.

Um contador numera compras, não compradores únicos. Reutilizar um ID para todas as compras do mesmo comprador exige um mapeamento separado de comprador para ID e uma redefinição explícita no início de cada transmissão. O campo reason da memória do usuário é texto descritivo, não um contador dedicado de IDs de compradores.

Etiquetas de itens do Whatnot

Baixar o fluxo de exemplo do Whatnot. Imprime o comprador em negrito, o nome do item e um ID de pedido quando fornecido. Um aviso de falha no pagamento imprime uma etiqueta separada de FALHA NO PAGAMENTO etiqueta com os detalhes disponíveis nessa notificação.

1. No aplicativo independente, configure Controle da impressora para sua impressora e tamanho de papel e execute o teste de alinhamento.
2. Abra: Editor do Event Flow, escolha Importar, e selecione o arquivo JSON baixado.
3. Selecione Whatnot: etiquetas de itens + avisos de pagamento. Revise as duas ações de impressão; elas herdam a impressora global e o comprimento da etiqueta.
4. Ative o fluxo e salve. Mantenha a fonte Whatnot aberta com a captura de eventos da transmissão ativada.

O exemplo é importado desativado. Ele usa Event Type (Advanced) → Custom Event para product_sold e payment_failed, com um filtro de fonte Whatnot. Lances e avisos de encerramento de leilão não imprimem etiquetas.

Etiquetas de comprimento fixo sem surpresas

Etiquetas de 3 × 1 polegada (incluindo uma configuração Munbyn BT320): use largura de 76.2 mm e comprimento fixo de 25.4 mm quando o lado de 1 polegada for o sentido de avanço. Configure o mesmo papel e orientação nas Preferências de impressão do Windows. Comece com texto de 12–14 pt e teste nomes longos de comprador e item.

As bordas laterais do teste de alinhamento marcam a largura segura após a configuração selecionada de área imprimível e margens de segurança. A altura da caixa acompanha o texto de teste; não contorna a etiqueta inteira nem toca nas bordas físicas do papel.

• Meça no sentido de avanço do papel. Uma etiqueta de 62 × 29 mm normalmente usa largura de papel de 62 mm e comprimento fixo de etiqueta de 29 mm.
• Configure o Windows da mesma forma. Selecione o papel exato, orientação, detecção de intervalo/marca e comportamento do cortador nas Preferências de impressão do driver.
• Fixo significa fixo. O Social Stream não adiciona espaço de avanço de recibo a um trabalho de comprimento fixo. Conteúdo alto demais pode ser cortado ou passar para outra etiqueta, dependendo do driver.
• Teste os dados mais longos plausíveis. Nomes longos de espectadores, variações de produtos, rótulos de moeda e várias linhas precisam de mais espaço ou fonte menor.
• Os limites do driver ainda se aplicam. O Windows ou o driver pode limitar páginas personalizadas muito curtas; o Social Stream solicita um mínimo de 20 mm.

Ideias para transmissões

• Imprima adesivos com nomes de apoiadores para uma parede, objeto de cena, mapa ou quadro físico de progresso.
• Crie etiquetas de pedidos de produtos, encomendas, bebidas ou retirada conforme as compras chegam.
• Imprima bilhetes de rifa ou comprovantes de participação em sorteios, com limites de frequência e verificações de elegibilidade antes da ação de impressão.
• Faça crachás VIP, identificações de equipes, fichas de desafios ou etiquetas de marcos de doação.
• Imprima uma pequena fila de moderação ou entrega para um produtor que trabalha ao lado do streamer.

Correções comuns

• Nenhuma impressora aparece: confirme que o Windows imprime uma página de teste, reinicie o Social Stream e selecione Encontrar impressoras novamente.
• O trabalho informa sucesso, mas nada imprime: abra a fila do Windows dessa impressora e verifique erros de pausa, offline, papel, driver ou porta.
• Uma borda está cortada: mantenha Usar área imprimível ativado e aumente a margem de segurança desse lado.
• Há papel em branco demais: use comprimento fixo 0 para recibos, reduza a margem inferior e o avanço ou defina o comprimento exato para etiquetas.
• Uma etiqueta vira duas: o conteúdo é mais alto que a etiqueta fixa ou o Windows está usando o tamanho de papel errado. Reduza texto, tamanho da fonte, espaçamento entre linhas e margens.
• A impressora errada é usada em Testar fluxo: escolha uma impressora específica no nó Print Thermal Label. Uma substituição em branco usa a impressora padrão do Windows ao testar diretamente no editor.