Пошаговое руководство по настройке встроенных 2D-сканеров Zebra, Movfast, Urovo и Honeywell для работы в приложении «Ревизор»
💡 Как система принимает сканы от ТСД
Приложение работает в высокопроизводительном нативном WebView. Для надёжного считывания штрихкодов в любых условиях без задержек терминал должен передавать данные одним из двух способов:
Эмуляция клавиатуры (Keyboard wedge): сканер отправляет символы штрихкода в фокус ввода и завершает строкой ENTER.
Системный Broadcast Intent: сканер мгновенно транслирует считанный код системным оповещением, которое приложение перехватывает в фоне.
Золотое правило настройки любого ТСД: режим вывода — Клавиатура / Keyboard, суффикс — Enter, префикс — пустой, белые списки приложений — выключены (или в них добавлен пакет ru.revizorius.mobile).
📱 Movfast S55 / Ranger XCheng Scanner
Терминалы сбора данных Movfast работают на платформе XCheng (служба com.xcheng.scannere3). По умолчанию на заводе часто включен режим вставки в курсор, блокирующий ввод в веб-оболочки.
1. Откройте приложение настроек сканера
В списке приложений найдите значок «Scanner Settings» (или «Настройки сканирования» / «Movprofile»).
2. Выберите режим вывода данных
Найдите строку «Режим вывода данных сканирования» (Scan Output Mode).
Нажмите на неё и выберите Output to keyboard или Output to broadcast/keyboard. Важно: стандартный режим «Output to the Cursor» не отправляет события клавиатуры в веб-приложения — его нужно переключить!
3. Установите суффикс ENTER
В разделе «Параметры форматирования вывода» проверьте значение «Suffix char 1»: должно быть выбрано ENTER (перевод строки).
Префиксы Prefix char 1 и Prefix char 2 оставьте пустыми (Empty).
4. Отключите «Белый список»
Найдите пункт «Белый список» (Whitelist). Переведите тумблер в выключенное состояние (серый), либо добавьте в белый список приложение ru.revizorius.mobile. При включенном белом списке сканер молчит во всех сторонних приложениях.
5. Проверьте размер области сканирования
В пункте «Размер области сканирования» рекомендуется значение 4/4 frame size или 1/16 frame size в зависимости от плотности штрихкодов на объекте.
✓ Готово на Movfast: в приложении «Ревизор» на первом экране включите галочку «сканер ТСД (аппаратная кнопка)». Приложение сразу определит терминал как Movfast S55 и будет мгновенно принимать сканы с боковых жёлтых кнопок.
⚠️ Если при первом запуске на Movfast S55 остаётся белый экран:
На некоторых версиях заводской прошивки Android 13 системный WebView даёт сбой в изолированном многопроцессном режиме (SandboxedProcessService). Решение: подключите терминал по USB и выполните команду в терминале:
adb shell cmd webviewupdate disable-multiprocess
(При установке через скрипт ./update-device.sh эта команда выполняется автоматически).
🦓 Zebra Technologies DataWedge
Подходит для терминалов Zebra TC20, TC21, TC25, TC26, MC33, MC93, EC50 и сканеров-колец серии RS. Сканированием управляет системная служба DataWedge.
1. Откройте приложение DataWedge
В списке приложений откройте DataWedge. В правом верхнем углу нажмите меню (три точки) → New profile (Новый профиль) и введите имя Revizor.
2. Привяжите профиль к приложению
Откройте созданный профиль Revizor → нажмите Associated apps (Связанные приложения) → меню → New app/activity.
В списке выберите пакет ru.revizorius.mobile, активность выберите со звёздочкой * (все активности).
3. Включите Barcode Input
В профиле в блоке Barcode input убедитесь, что стоит галочка Enabled (Включено), а Scanner selection установлен в Auto.
4. Настройте вывод Keystroke Output с суффиксом ENTER
В блоке Keystroke output:
• Поставьте галочку Enabled.
• Зайдите в Basic data formatting → включите галочки Send data и Send ENTER key. Внимание: в пункте Action key character оставьте None, если включен Send ENTER key — иначе придут два Enter подряд.
5. Выключите лишний вывод
В разделах Intent output и IP output снимите галочки Enabled.
✓ Готово на Zebra: при запуске «Ревизора» профиль активируется автоматически. Нажмите боковую кнопку — штрихкод будет введён и подтверждён.
📦 Urovo ScanSettings
Подходит для ТСД Urovo DT50, DT40, i6310, i6200 и сканеров-колец SR5600.
1. Откройте системные настройки сканирования
Откройте приложение «ScanSettings» (или «Настройки сканирования» в системных настройках Urovo).
2. Режим вывода (Output mode)
Выберите режим вывода: Keyboard input (Эмуляция клавиатуры / вывод в фокус).
3. Завершающий символ
В поле «Завершающий символ» (End character / Suffix) укажите Enter (или код \n). Префикс оставьте пустым.
4. Проверка символик
В разделе Символики убедитесь, что включены необходимые типы: EAN-13, EAN-8, Code 128, Code 39, QR Code, Data Matrix.
2. Настройте профиль по умолчанию (Default profile)
Откройте Default profile → перейдите в Data Processing Settings.
3. Режим клина (Wedge) и суффикс
• В пункте Wedge Method выберите Keyboard.
• В пункте Suffix Key выберите ENTER (или введите \n).
• Prefix оставьте пустым.
⚙️ Что включить в приложении «Ревизор»
1. Отметьте «Сканер ТСД (аппаратная кнопка)»
На первом экране авторизации / настройки поставьте галочку «сканер ТСД (аппаратная кнопка)». На поддерживаемых терминалах модель будет обнаружена автоматически.