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

Что можно напечатать?

Настольное приложение Windows может отправлять задания без диалога печати на принтер, установленный в Windows. Сценарий может объединять любые доступные значения — имя зрителя, пожертвование, товар, сообщение или счётчик — и управлять размером и выравниванием текста.

Правило совместимости: принтер должен появляться как рабочая очередь печати Windows. Social Stream печатает через установленный драйвер Windows и не отправляет необработанные команды ESC/POS, ZPL или SDK производителя.

Быстрая настройка

1. Подключите принтер по USB, включите его и установите драйвер Windows. Сначала напечатайте тестовую страницу Windows.
2. В Social Stream откройте Global settings and tools («Общие настройки и инструменты») → Управление принтером.
3. Выберите Найти принтеры и выберите точное имя очереди, показанное в Windows.
4. Введите физическую ширину бумаги, обычно 58, 80, или 62 мм в зависимости от устройства и бумаги.
5. Оставьте Фиксированная длина этикетки в разделе 0 для чека по размеру содержимого. Для готовых этикеток введите длину по направлению подачи в миллиметрах.
6. Выберите Проверка выравнивания печати. Если край отсутствует, увеличьте безопасное поле с этой стороны и повторите проверку.

Чековая лента, самоклеящийся рулон или готовые этикетки?

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

Печать этикетки пожертвования через Event Flow

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

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

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

Выберите Насыщенность → Выделенный текст (**жирный**), затем введите:

**{username}**
{subtitle}

Используйте одинарные фигурные скобки. Новые торговые интеграции передают название товара в subtitle; количество может передаваться в {meta.commerce.quantity}. Если предыдущий узел создаёт buyer, используйте **{buyer}** вместо этого. Shopify и eBay не передают личность покупателя, поэтому используйте для них локальный счётчик заказов или бирку только с товаром. Только текст, заключённый в ** станет жирным; пользовательский JavaScript или HTML не нужен. Существующие этикетки с полностью жирным или обычным текстом сохранят форматирование.

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

Счётчик нумерует покупки, а не уникальных покупателей. Чтобы все покупки одного покупателя получали один ID, нужно отдельное соответствие «покупатель — ID» и явный сброс в начале каждой трансляции. Поле причины в памяти пользователей — описательный текст, а не специальный счётчик ID покупателей.

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

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

1. В настольном приложении настройте Управление принтером для своего принтера и размера бумаги и запустите проверку выравнивания.
2. Откройте Редактор Event Flow, выберите Импорти выберите скачанный JSON-файл.
3. Выберите Whatnot: этикетки товаров и предупреждения об оплате. Проверьте оба действия печати; они наследуют общие настройки принтера и длины этикетки.
4. Включите сценарий и сохраните его. Держите источник Whatnot открытым с включённым захватом событий трансляции.

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

Этикетки фиксированной длины без сюрпризов

Этикетки 3 × 1 дюйм (в том числе для Munbyn BT320): используйте ширину 76,2 мм и фиксированную длину 25,4 мм, если подача идёт вдоль стороны в 1 дюйм. Выберите такой же формат и ориентацию в параметрах печати Windows. Начните со шрифта 12–14 пт и проверьте длинные имя покупателя и название товара.

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

• Измеряйте вдоль подачи бумаги. Для этикетки 62 × 29 мм обычно задают ширину бумаги 62 мм и фиксированную длину 29 мм.
• Согласуйте настройки Windows. Выберите точный формат этикеток, ориентацию, датчик зазора или метки и поведение резака в параметрах печати драйвера.
• Фиксированный размер не растягивается. Social Stream не добавляет место для протяжки чека к заданию фиксированной длины. Слишком высокое содержимое может обрезаться или переноситься в зависимости от драйвера.
• Проверяйте самые длинные реалистичные данные. Длинным именам зрителей, вариантам товаров, обозначениям валют и нескольким строкам нужно больше места или меньший шрифт.
• Ограничения драйвера сохраняются. Windows или драйвер могут ограничивать слишком короткие пользовательские страницы; Social Stream запрашивает минимум 20 мм.

Идеи для трансляции

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

Решение частых проблем

• Принтер не появляется: убедитесь, что Windows печатает тестовую страницу, затем перезапустите Social Stream и снова выберите поиск принтеров.
• Задание считается успешным, но ничего не печатается: откройте очередь этого принтера в Windows и проверьте паузу, автономный режим, бумагу, ошибки драйвера или порта.
• Край обрезан: оставьте использование области печати включённым и увеличьте безопасное поле с нужной стороны.
• Слишком много пустой бумаги: для чеков задайте фиксированную длину 0, уменьшите нижнее поле и протяжку либо установите точную длину для готовых этикеток.
• Одна этикетка превращается в две: содержимое выше фиксированной этикетки либо в Windows выбран неверный размер бумаги. Уменьшите объём текста, шрифт, межстрочный интервал и поля.
• В проверке сценария используется не тот принтер: задайте переопределение принтера в узле Print Thermal Label. При пустом значении во время прямой проверки в редакторе используется принтер Windows по умолчанию.