Как выбрать стабильную библиотеку для сканирования QR-кодов

Проблема, когда сканер QR-кодов не видит код на терминале, знакома многим разработчикам. Чаще всего это связано не с «багнутостью» библиотеки, а с неправильным выбором инструмента под конкретные условия съёмки. Разберём, какие библиотеки действительно работают стабильно и почему возникают проблемы с распознаванием.

Почему сканер может не видеть QR-код на терминале?

Терминалы обычно имеют глянцевые экраны с высокой яркостью и мерцанием (PWM). Стандартные библиотеки, оптимизированные для печатных кодов, часто дают сбои при съёмке с экрана. Основные причины: блики, низкий контраст, искажения из-за угла наклона камеры и недостаточная чувствительность к динамическому диапазону.

Лучшие библиотеки для сканирования QR-кодов

ZXing (Zebra Crossing)

Одна из самых популярных open-source библиотек. Поддерживает Java, Kotlin, C++ и другие языки. Для Android используется com.google.zxing:core и com.journeyapps:zxing-android-embedded. Минус: при слабом освещении и на глянцевых экранах может работать нестабильно, требуются дополнительные настройки контраста.

ML Kit от Google

Современная библиотека на базе машинного обучения. Отлично распознаёт QR-коды даже с экранов терминалов, устойчива к бликам и искажениям. Для интеграции на Android используйте com.google.mlkit:barcode-scanning. Решение рекомендуется для production-проектов, где важна точность.

Dynamsoft Barcode Reader

Коммерческая библиотека с высокой скоростью и точностью. Поддерживает множество форматов, включая QR-коды на экранах. Есть версии для iOS, Android, веба и десктопа. Отлично справляется с низким контрастом и мерцанием.

QuaggaJS (для веба)

JavaScript-библиотека для браузеров. Хорошо работает с камерой, но требует настройки параметров декодинга для экранов. Может не справляться с быстрым мерцанием терминалов.

Как улучшить распознавание QR-кодов с экрана?

Если вы используете ZXing или другую библиотеку, попробуйте следующие приёмы:

• Увеличьте контраст - настройте параметры TryHarder или PureBarcode.
• Используйте предобработку изображения - бинаризация с адаптивным порогом (например, Otsu) помогает убрать блики.
• Настройте частоту кадров - снизьте FPS до 15-20, чтобы избежать артефактов от мерцания экрана.
• Выберите библиотеку с поддержкой ML - ML Kit или Dynamsoft автоматически компенсируют искажения.

Что выбрать для стабильной работы?

Для проектов, где критична точность (например, сканирование на кассах или в терминалах оплаты), лучше всего подходит ML Kit от Google или Dynamsoft Barcode Reader. Если бюджет ограничен - используйте ZXing с дополнительной обработкой изображения. Для веб-приложений - QuaggaJS с настройками под экран.