Термопринтеры и этикетки для трансляций

Превратите покупки, пожертвования и события чата в настоящие чеки, стикеры, билеты или бирки выдачи заказов.

Настройте за 6 шагов

Перед началом: нужно отдельное приложение Windows. Принтер должен отображаться как обычный принтер Windows. Social Stream печатает через драйвер Windows и не отправляет сырые команды ESC/POS, ZPL или SDK производителя.
  1. Подключите принтер по USB, включите его и установите драйвер Windows. Напечатайте тестовую страницу Windows для проверки.
  2. В Social Stream откройте Общие настройки и инструменты → Механика — Соединения и интеграции → Управление принтером.
  3. Нажмите Найти принтеры. Выберите принтер по имени в Windows.
  4. Введите Ширина бумаги (мм). Обычно это 58, 80, или 62.
  5. Оставьте Фиксированная длина этикетки в разделе 0 для чековой бумаги. Для высечных этикеток введите длину в мм по направлению подачи бумаги.
  6. Нажмите Тестовая печать. Если край обрезан, увеличьте безопасный отступ с этой стороны и проверьте снова.

Безопасные отступы по 2 мм слева и справа подходят многим недорогим чековым принтерам 58 мм. Реальную область печати определяет драйвер, поэтому оставьте Использовать область печати выбранным, если вы не проверили другой вариант.

Печатайте этикетку при пожертвовании

💰 Пожертвование / чаевыеМинимальная сумма: 10
🖨️ Напечатать термоэтикетку{username}
{donation}

24 пт · жирный · по центру
  1. Откройте Редактор Event Flow и создайте новый поток.
  2. Добавьте Пожертвование / чаевые в качестве триггера. Задайте Минимальная сумма если печатать нужно только крупные пожертвования.
  3. Добавить Напечатать термоэтикетку (в разделе интеграций) и подключите к нему триггер.
  4. Введите {username}, новую строку, затем {donation}. Выберите размер и толщину шрифта, выравнивание и число копий.
  5. Оставьте переопределения принтера и фиксированной длины в действии пустыми или 0. Будут использованы ваши настройки Printer Control.
  6. Нажмите Проверить сценарий. Введите имя и включите Сумма пожертвования (Has Donation), добавьте сумму и запустите. Будет напечатана настоящая этикетка.

Другие полезные подстановки: {message}, {source}, {donationAmount}, и {counterValue}. Значения, созданные предыдущими шагами потока, также работают.

Печатайте продажи, подарки и номера заказов

Я хочу печатать…Что сделать
ПродажиИспользуйте Тип события с purchase. Пожертвование / чаевые требует hasDonationпоэтому пропускает большинство продаж.
Завершённые подаркиИспользуйте gift или giftfunded. При необходимости отфильтруйте по поставщику.
Последовательный номер заказаДобавьте Счётчик перед действием печати.

См. поля торговых событий для состава данных каждой продажи.

Покупатель — жирным, товар — обычным

  1. Установите Толщина на Выделенный текст.
  2. Введите этот текст этикетки:
**{username}**
{subtitle}
  • Только текст внутри ** становится жирным. HTML и JavaScript не нужны.
  • Используйте одинарные фигурные скобки. В продажах название товара находится в {subtitle}. Количество может быть в {meta.commerce.quantity}.
  • Если предыдущий шаг создаёт buyer, используйте **{buyer}** вместо этого.
  • Shopify и eBay не передают имя покупателя. Используйте для них счётчик заказов или этикетку только с товаром.
  • Этикетки с настройкой «Всё жирным» или «Обычный» сохраняют вид.
Для авторов потоков: результаты печати и номера покупателей

Действие добавляет meta.thermalPrintResult.successа при сбое — ошибку или код для следующих шагов. Успех означает отправку задания в Windows, а не выход бумаги. Перед повтором проверьте очередь печати Windows, иначе возможны дубли этикеток.

Счётчик нумерует покупки, а не уникальных покупателей. Чтобы все покупки одного человека получали одинаковый номер, нужен отдельный список покупатель–номер со сбросом в начале каждого эфира. Поле причины в User Memory — обычный текст, а не счётчик номеров покупателей.

Этикетки товаров Whatnot

Скачать пример сценария Whatnot. Печатает имя покупателя жирным, название товара и ID заказа, если он есть. При сбое оплаты печатает отдельную ОПЛАТА НЕ ПРОШЛА этикетку с теми сведениями, которые есть в уведомлении.

  1. В отдельном приложении настройте Управление принтером и выполните тестовую печать.
  2. Откройте Редактор Event Flow, нажмите Импорти выберите скачанный файл.
  3. Выберите Whatnot: этикетки товаров и предупреждения об оплате. Проверьте оба действия печати. Они используют принтер и длину этикетки из Printer Control.
  4. Включите поток и сохраните. После импорта он выключен.
  5. Оставьте источник Whatnot открытым с включённым захватом событий эфира.
Этикетка продажи не означает оплату. Каждое уведомление печатается при получении. Поток не ждёт оплаты, не исправляет старую этикетку и не выдаёт номера покупателей. Отсутствующие поля остаются пустыми. Уведомление об ошибке без покупателя, товара или данных заказа не позволяет определить нужную этикетку.
Как работает пример потока

Использует Тип события (дополнительно) → Пользовательское событие для пункта product_sold и payment_failedс фильтром Whatnot. Ставки и уведомления о завершении аукциона не печатаются. См. поля событий Whatnot.

Выберите бумагу

Чековая лента

Для покупных квитанций, талонов очереди и чеков любой длины. Оставьте фиксированную длину этикетки равной 0.

Непрерывная самоклеящаяся лента

Для клейких полосок с именем любой длины. Работает как чековая бумага, но резку должен выполнять принтер или драйвер.

Готовые этикетки

Для одинаковых бейджей и товарных этикеток. Задайте точную фиксированную длину и выберите тот же материал в настройках печати Windows.

Примеры принтеров

ПринтерПодходит дляПримечания
Типовой «POS-58»Недорогие чеки 58 ммОбычно USB. Названия и драйверы зависят от продавца. Для проверки Social Stream использовался базовый POS-58.
Epson TM-T20IIIБолее надёжный чековый принтерUSB. Бумага 80 мм или 58 мм с комплектным адаптером.
Brother QL-800Наклейки и именные этикеткиUSB. До 62 мм, высечные или непрерывные, с автоматическим резаком.
Brother QL-820NWBОбщая или сетевая станция печати этикетокUSB, Ethernet, Wi-Fi и Bluetooth.
Zebra ZD220Более широкие товарные, адресные этикетки или браслетыUSB. Материал примерно 25–112 мм. Версии прямой термопечати и термотрансферной печати.

Это примеры, а не список проверенных устройств. Перед покупкой убедитесь, что конкретная модель имеет актуальный драйвер Windows, поддерживает размер этикетки и отображается как обычный принтер Windows.

Правильно настройте этикетки фиксированного размера

Этикетки 3 × 1 дюйм (включая Munbyn BT320): задайте ширину 76.2 мм, а фиксированную длину на 25.4 мм, если первой подаётся сторона 1 дюйм. Выберите тот же материал и направление в настройках печати Windows. Начните с текста 12–14 пт.
ПравилоПочему
Измеряйте в направлении подачиЭтикетка 62 × 29 мм обычно имеет ширину 62 мм и фиксированную длину 29 мм.
Согласуйте настройки WindowsВ настройках печати драйвера задайте тот же материал, направление, распознавание зазора/метки и резак.
Фиксированная длина не меняетсяДополнительная протяжка не добавляется. Слишком высокий текст может обрезаться или перейти на следующую страницу в зависимости от драйвера.
Проверьте самый длинный текстДлинные имена, варианты товара и дополнительные строки требуют больше места или меньшего шрифта.
Очень короткие этикетки могут не работатьSocial Stream запрашивает минимум 20 мм. Драйвер всё равно может ограничивать короткие страницы.

Боковые границы тестовой печати показывают безопасную ширину. Высота следует за тестовым текстом. Контур всей этикетки не рисуется.

Идеи для эфира

  • Наклейки с именами поддержавших для стены, реквизита, карты или доски прогресса.
  • Этикетки мерча, индивидуальных заказов, напитков или выдачи при поступлении заказов.
  • Лотерейные билеты. Перед печатью добавьте ограничения частоты и проверки права участия.
  • VIP-бейджи, выбор команд, жетоны заданий или этикетки этапов.
  • Краткий список задач для продюсера рядом с вами.
Не печатайте личные данные. Не включайте адреса, email, платёжные данные и личные сообщения. Термобумага также выцветает от тепла, света и со временем.

Устранение неполадок

ПроблемаЧто попробовать
Принтер не отображаетсяУбедитесь, что Windows печатает тестовую страницу. Перезапустите Social Stream и снова нажмите «Найти принтеры».
Сообщается об успехе, но печати нетОткройте очередь принтера в Windows. Проверьте паузу, автономный режим, ошибки бумаги, драйвера или порта.
Край обрезаетсяОставьте использование печатной области включённым. Увеличьте безопасный отступ с этой стороны.
Слишком много пустой бумагиДля чеков задайте фиксированную длину 0. Уменьшите нижнее поле и дополнительную протяжку. Для этикеток задайте точную длину.
Одна этикетка печатается на двухТекст выше этикетки или в Windows задан неверный размер материала. Уменьшите текст, шрифт, интервалы или поля.
Тест потока использует не тот принтерВыберите переопределение принтера в шаге печати термоэтикетки. Если поле пустое, тест в редакторе использует принтер Windows по умолчанию.