2D Code Scanner

FAQ по сканеру штрихкодов

Настройка, сканирование и что проверить, если сканер не может связаться с ПК.

Начало работы

Что делает 2D Code Scanner?

Он передаёт штрихкоды со сканера на Android в Companion для Windows или macOS (Linux — экспериментально) в той же локальной сети. Companion вводит каждый код в то поле, которое активно на ПК, как клавиатурный эмулятор (keyboard wedge).

Работает ли это как keyboard wedge?

Да. Companion вводит каждый штрихкод в активное поле на ПК так же, как это делал бы keyboard wedge. После каждого скана можно добавлять Enter или Tab.

Можно ли использовать это вместо USB-сканера штрихкодов?

Да. Устройство Zebra или ваш телефон заменяет отдельный USB-сканер. Companion вводит код в активное поле в Windows, macOS или в экспериментальной версии для Linux.

Что нужно установить?

Обе части. Установите Companion для компьютера на ПК и одно приложение для Android: Zebra, Камера, HoneywellСкоро, UrovoСкоро, NewlandСкоро, DatalogicСкоро или UniversalСкоро. Для сканера нужен Companion версии 1.1.0 или новее.

Приложение Zebra или «Камера»?

Выбирайте приложение под своё устройство. Zebra и UrovoСкоро работают через DataWedge. HoneywellСкоро использует Data Collection. NewlandСкоро использует NLScan. DatalogicСкоро использует Intent Wedge. Камера использует камеру телефона.

UniversalСкоро использует встроенный сканер производителя, если он установлен, а в остальных случаях — камеру.

Bluetooth не используется.

Нужны ли аккаунт или подписка?

Нет. Нет ни облачного аккаунта, ни подписки. Штрихкоды остаются на сканере и ПК. Соединение шифруется в вашей сети с помощью AES-256-GCM.

Сопряжение

Как выполнить сопряжение сканера с ПК?
  1. Откройте Companion. Если окно скрыто, он может находиться в трее.
  2. Подключите сканер и ПК к одной локальной сети.
  3. На устройстве Zebra наведите сканер на QR-код и нажмите аппаратную кнопку сканирования. В приложении «Камера» нажмите Scan.
  4. На сканере должно появиться Connected.

Если у ПК несколько сетевых адаптеров, откройте в Companion Settings → Connection Wizard (или ссылку Connection Wizard на главном экране). Мастер рекомендует адрес в локальной сети, помогает с брандмауэром и показывает сканеры, которые появляются, когда на устройстве открыт раздел Connections. Также можно вручную указать в поле Network адрес, доступный для сканера, прежде чем сканировать QR-код.

Нужно ли выполнять сопряжение заново каждый раз?

Нет. Сопряжение сохраняется в разделе Connections на сканере (нажмите на строку подключения на главном экране). Companion сохраняет тот же токен сопряжения при выходе и повторном запуске, поэтому сканер подключается сам.

Если адрес ПК в той же сети изменился, Companion объявляет новый адрес, и сохранённое подключение обновляется. Сканируйте QR-код заново, только если ПК перешёл в другую сеть или вы заново создали QR-код.

Можно ли использовать несколько ПК?

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

Что делает Regenerate QR?

Создаёт новый токен сопряжения и отключает все сканеры. Каждому устройству нужно отсканировать новый QR-код, чтобы снова подключиться. Используйте это, когда хотите аннулировать старые сопряжения, а не когда просто изменился IP-адрес.

Сканер пишет, что Companion слишком старый

Установите Companion 1.1.0 или новее из раздела Загрузки или воспользуйтесь пунктом Check for updates в настройках Companion. Старые версии Companion отклоняются и не смогут подключиться, пока приложение на ПК не будет обновлено.

Сканирование

Код отображается на устройстве, но на ПК ничего не вводится

Сначала щёлкните в текстовом поле. Companion вводит текст в активное окно.

В Settings Companion оставьте включённым Type into focused window. На сканере Resend last scan отправляет последний код ещё раз, когда соединение восстановлено.

Совпавшие позиции в открытой сессии проверки или подсчёта намеренно остаются на устройстве. Они не вводятся на ПК. См. Сессии инвентаризации.

Если статус не Connected, скан ставится в очередь и отправляется после восстановления соединения. Если подключиться не удаётся, начните с диагностики сети.

Как отправлять Enter или Tab после каждого скана?

На сканере откройте Settings и выберите для After each scan значение Enter, Tab или None. По умолчанию выбран Enter.

Какие штрихкоды поддерживаются?

Code 128, Code 39, Code 93, EAN-8, EAN-13, UPC-A, UPC-E, Interleaved 2 of 5, GS1 DataBar, QR Code, Data Matrix, PDF417, Aztec, MaxiCode, MicroPDF417 и Micro QR Code.

На устройстве Zebra нужный тип кода также должен быть включён в DataWedge. Приложение «Камера» читает то, что встроенный сканер может распознать по изображению с камеры.

Кнопка сканирования на Zebra ничего не делает

При первом запуске создаётся профиль DataWedge с именем 2DCodeScanner (ввод штрихкодов, вывод через intent в это приложение, вывод нажатий клавиш отключён). Убедитесь, что этот профиль существует и связан с этим приложением.

Этому приложению нужно устройство Zebra с DataWedge. Устройства других марок на Android и приложение «Камера» этот профиль не используют.

Приложение «Камера» не сканирует

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

Сессии инвентаризации

Что такое сессия проверки?

Список ожидаемых штрихкодов. Создайте его на сканере или в Companion в разделе Tools → Validation, затем отправьте на сканер. Совпавшие сканы отмечают позиции в списке. На ПК они не вводятся.

Когда все позиции отмечены, сессия завершена. Reset / undo на устройстве снимает отметки, чтобы можно было просканировать список снова. Return to building снимает отметки и позволяет добавлять или удалять коды.

Что такое сессия подсчёта?

Подсчёт количества. Создайте его на сканере (Sessions → Counting) или в Companion (Tools → Counting), затем откройте на устройстве и сканируйте. Количества синхронизируются обратно с Companion. Companion может скопировать итог в формате TSV.

Почему скан остался на устройстве во время сессии?

Пока открыт экран сессии проверки или подсчёта, сканы относятся к этой сессии. Выйдите из сессии, чтобы вводить обычные штрихкоды в активное поле на ПК.

Диагностика сети

Сканер и Companion общаются только в вашей локальной сети. Они не используют интернет, Bluetooth или облачный ретранслятор. Телефон, который открывает сайты, всё равно может не достучаться до ПК, если гостевой Wi‑Fi, изоляция клиентов, VPN или брандмауэр блокируют трафик между устройствами.

Проверьте по порядку

  1. Companion действительно запущен

    Закрытие окна сворачивает его в трей, если включено Close to tray. Сканеры при этом по-прежнему принимаются. Quit в меню значка в трее завершает работу.

  2. Оба устройства в одной локальной сети

    Сканер использует Wi‑Fi. ПК может быть в той же сети Wi‑Fi или подключён по Ethernet к той же локальной сети. В гостевых сетях, публичных точках доступа и точках доступа с изоляцией клиентов устройства не видят друг друга, даже если у обоих есть интернет.

  3. В QR-коде указан адрес, доступный для сканера

    В Settings → Network Companion перечислены адреса ПК в локальной сети. Выберите адрес офисной сети Wi‑Fi или Ethernet (часто 192.168… или 10…). Пропустите адаптеры VPN, виртуальных машин и гипервизоров. Или воспользуйтесь Connection Wizard — рекомендуемые адаптеры помечены, а ваш сканер должен появиться в списке, когда открыт раздел Connections или мастер приветствия находится на шаге подключения. После изменения этого параметра отсканируйте QR-код заново.

  4. Брандмауэр разрешает Companion

    Разрешите входящие подключения TCP и UDP 17832 (или порта, который вы задали в Settings → Port). По TCP идёт само соединение. По UDP на том же порту сохранённый сканер узнаёт новый адрес ПК после смены DHCP, а Companion видит сканер в Connection Wizard.

  5. Отсканируйте актуальный QR-код

    Сделайте это после смены сети, порта или локальной сети ПК. Новый QR-код не нужен только потому, что в той же сети изменился IP.

Если проблема осталась

  • Статус остаётся Connecting или Not connected

    • Отключите VPN на телефоне и на ПК, затем отсканируйте QR-код заново. VPN часто скрывает адрес ПК в локальной сети.
    • Выйдите из гостевого Wi‑Fi. Используйте частную локальную сеть, где телефоны и ПК видят друг друга.
    • Чтобы проверить приложения без офисной сети, подключите ПК к точке доступа телефона-сканера (или подключите оба устройства к небольшому дорожному роутеру) и отсканируйте QR-код там.
    • В Windows разрешите Companion в Private сетях. Сеть с профилем Public часто блокирует входящие подключения с других устройств.
    • В macOS разрешите доступ к локальной сети, если система запросит. В Linux разрешите этот же порт для TCP и UDP.

  • Раньше всё работало, но адрес ПК изменился

    • Не трогайте токен сопряжения. Regenerate QR заставляет все сканеры выполнить сопряжение заново.
    • Если этот UDP-порт разрешён, Companion объявляет новый адрес, и сохранённое подключение обновляется. Если порт заблокирован, один раз отсканируйте актуальный QR-код.
    • Другая сеть (офис и дом или новая VLAN) требует нового сканирования QR-кода.

  • Соединение обрывается при выключении экрана

    • Пока дисплей выключен, сканер приостанавливает соединение по Wi‑Fi. В уведомлении сказано, что соединение приостановлено.
    • Включите Keep screen on в настройках сканера или разбудите экран, чтобы переподключиться.
    • Дайте разрешение на уведомления, если Android его запросит. Без него служба сканера не сможет оставаться запущенной.

  • Сканы остаются на устройстве

    • Если статус не Connected, скан ставится в очередь и отправляется после переподключения. Он не теряется.
    • Если открыт экран проверки или подсчёта, скан сохраняется в этой сессии и не вводится на ПК.
    • Если на главном экране статус Connected, щёлкните в текстовом поле на ПК и убедитесь, что включено Type into focused window.

  • Вы изменили порт

    • Порт указан в QR-коде. Примените его в настройках Companion, затем отсканируйте новый QR-код.
    • Разрешите этот порт и для TCP, и для UDP. Сканер, который уже сохранил этот Companion, узнаёт новый порт из объявления. Сканер, который его ещё не сохранял, по-прежнему рассылает сигналы на порт 17832, поэтому первое сопряжение выполните по QR-коду.
    • Если порт уже занят другой программой, Companion не сможет его прослушивать. Выберите свободный порт выше 1024.

Всё ещё не получается? Напишите на office@updruck.com, указав версию Companion (Settings на ПК), версию приложения Android (Settings на сканере), адрес, выбранный в разделе Network, и сообщите, находится ли телефон в гостевом Wi‑Fi или за VPN.