QZ Tray — это десктопный агент и набор JavaScript-интерфейсов, предназначенный для интеграции веб-приложений с локальными периферийными устройствами, в частности для печати на локальных принтерах и управления последовательными или USB-устройствами. Программный комплекс обычно устанавливается на компьютере пользователя и обеспечивает защищённый канал между браузерным кодом и аппаратными устройствами, обходя ограничение браузеров на прямой доступ к системным портам. QZ Tray реализует клиент-серверную архитектуру, где агент слушает локальные запросы от веб-страниц, подписанных соответствующими сертификатами, и переводит их в команды для драйверов и устройств.
В историческом контексте QZ Tray возник как решение для предприятий розничной торговли, ресторанного бизнеса и складских систем, где требуется печать чеков, этикеток и наклеек непосредственно из веб-интерфейсов без установки полноценных локальных приложений. Продукт сочетает в себе кроссплатформенную совместимость с основными настольными операционными системами и поддержку широкого спектра принтеров, включая термопринтеры и специализированные устройства. Документация и примеры обычно показывают, как настроить соединение, отправить команды печати и управлять параметрами устройств через JavaScript API.
- Локальный агент: устанавливаемый сервис/программа, принимающая запросы от браузера и выполняющая взаимодействие с устройствами операционной системы.
- JavaScript API: набор функций для открытия соединений, отправки данных на печать и получения статуса устройств непосредственно из веб-приложений.
- Поддержка принтеров: возможность печати на термопринтерах, чековых принтерах и стандартных настольных принтерах с управлением форматированием и управляющими последовательностями.
- Работа с портами: управление последовательными (COM) и USB-интерфейсами для обмена данными с периферией.
- Кроссплатформенность: выпуски агента для Windows, macOS и Linux, обеспечивающие одинаковый API на стороне клиента.
- Безопасность соединения: использование подписи запросов и механизмов авторизации для ограничения доступа веб-страниц к локальным ресурсам.
- Форматы данных: поддержка отправки сырых байтов, текста и форматов изображений, а также управляющих последовательностей ESC/POS и подобных протоколов.
- Интеграция в POS-системы: распространённое применение в системах точки продаж, онлайн-кассах и сервисах, требующих мгновенной локальной печати.
- Конфигурация и отладка: утилиты и журналы для настройки подключения к устройствам и диагностики проблем с печатью.
- Коммьюнити и примеры: наличие примеров кода и шаблонов для быстрого внедрения в веб-приложения и демонстрации типичных сценариев использования.