条码扫描器常见问题

安装设置、扫码,以及扫描设备无法连接电脑时该检查什么。

快速入门

2D Code Scanner 能做什么?

它会把 Android 扫描设备扫到的条码,通过同一局域网发送到 Windows 或 macOS 版 Companion(Linux 为实验性支持)。Companion 会像键盘模拟输入一样,把每个条码输入到电脑上当前获得焦点的字段中。

它的工作方式像键盘模拟输入吗?

是的。Companion 会把每个条码输入到电脑上当前获得焦点的字段中,与键盘模拟输入的效果相同。你可以让它在每次扫码后附加回车键或 Tab 键。

可以用它代替 USB 条码扫描枪吗?

可以。Zebra 设备或你的手机可以取代单独的 USB 扫描枪。Companion 会在 Windows、macOS 或实验性的 Linux 上,把条码输入到当前焦点字段。

需要安装什么?

两端都要安装。在电脑上安装桌面端 Companion,并在 Android 设备上安装下列应用之一:Zebra、Camera、Honeywell即将推出、Urovo即将推出、Newland即将推出、Datalogic即将推出或Universal即将推出。扫描设备需要 Companion 1.1.0 或更高版本。

该选 Zebra 应用还是 Camera 应用?

选择与设备匹配的应用。Zebra和Urovo即将推出使用 DataWedge,Honeywell即将推出使用 Data Collection,Newland即将推出使用 NLScan,Datalogic即将推出使用 Intent Wedge,Camera使用手机摄像头。

Universal即将推出在已安装对应扫描引擎时使用厂商自带的扫描头,否则使用摄像头。

不使用 Bluetooth。

需要账号或订阅吗?

不需要。没有云端账号,也没有订阅。条码只保存在扫描设备和电脑上,连接在你的网络内通过 AES-256-GCM 加密。

配对

如何将扫描设备与电脑配对?
  1. 打开 Companion。如果窗口被隐藏,它可能还在系统托盘里。
  2. 让扫描设备和电脑连接到同一个局域网。
  3. 在 Zebra 设备上,对准二维码并按下硬件扳机键。在 Camera 应用中,点按 Scan。
  4. 扫描设备上应显示 Connected。

如果电脑有多个网络适配器,请打开 Companion 的 Settings → Connection Wizard(或首页上的 Connection Wizard 链接)。向导会推荐局域网地址、协助处理防火墙,并列出你在设备上打开 Connections 时出现的扫描设备。你也可以在扫描二维码之前,手动把 Network 设置为扫描设备能够访问的地址。

每次都要重新配对吗?

不需要。配对信息保存在扫描设备的 Connections 中(点按主屏幕上的连接状态行即可)。退出并重新打开 Companion 后,它仍使用相同的配对令牌,扫描设备会自动重新连接。

如果电脑在同一网络内地址发生变化,Companion 会广播新地址,已保存的连接会随之更新。只有当电脑换到另一个网络,或你重新生成了二维码时,才需要再次扫描二维码。

可以使用多台电脑吗?

可以。扫描各个 Companion 的二维码即可保存。你可以在 Connections 中为连接命名、切换当前连接或将其删除。

“重新生成二维码”有什么作用?

它会创建新的配对令牌,并断开所有扫描设备。每台设备都必须扫描新的二维码才能再次连接。当你想让旧的配对失效时才使用它;如果只是 IP 地址变了,不需要这样做。

扫描设备提示 Companion 版本过旧

请从下载页面安装 Companion 1.1.0 或更新版本,或在 Companion 设置中使用 Check for updates。版本过旧的 Companion 会被拒绝连接,更新电脑端应用后才能重新连接。

扫码

设备上显示了条码,但电脑上没有任何输入

请先点击一个文本字段。Companion 会把内容输入到当前获得焦点的窗口。

在 Companion 的 Settings 中,请保持 Type into focused window 处于开启状态。在扫描设备上,连接恢复后可以用 Resend last scan 重新发送上一个条码。

在已打开的校验或计数会话中,匹配的条目会特意保留在设备上,不会输入到电脑。参见盘点会话。

如果状态不是 Connected,扫码内容会先进入队列,待连接恢复后发送。如果始终连不上,请先查看网络故障排查。

如何在每次扫码后发送回车键或 Tab 键?

在扫描设备上打开 Settings,将 After each scan 设为回车、Tab 或无。默认是回车。

支持哪些条码?

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 中启用。Camera 应用则读取设备端扫描器能从摄像头画面中解码的内容。

按 Zebra 扳机键没有反应

首次启动时会创建一个名为 2DCodeScanner 的 DataWedge 配置文件(条码输入、以 Intent 输出到本应用、关闭键盘输出)。请确认该配置文件存在,并已与本应用关联。

本应用需要带有 DataWedge 的 Zebra 设备。其他 Android 品牌以及 Camera 应用不使用该配置文件。

Camera 应用无法扫码

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,也可以通过以太网接入同一局域网。访客网络、公共热点以及开启了客户端隔离的接入点,即使双方都能上网,设备之间也互相看不到。

  3. 二维码使用的是扫描设备能访问的地址

    Companion 的 Settings → Network 会列出电脑的局域网地址。请选择办公室 Wi‑Fi 或以太网的地址(通常以 192.168… 或 10… 开头)。不要选择 VPN、虚拟机和虚拟化平台的适配器。也可以使用 Connection Wizard —— 推荐的适配器带有标记,当 Connections 打开或欢迎流程处于连接步骤时,你的扫描设备会出现在列表中。更改后请重新扫描二维码。

  4. 防火墙已放行 Companion

    允许入站 TCP 和 UDP 17832(或你在 Settings → Port 中设置的端口)。TCP 负责承载连接;同一端口上的 UDP 则让已保存的扫描设备在 DHCP 改变电脑地址后找到新地址,也让 Companion 能在 Connection Wizard 中看到扫描设备。

  5. 扫描当前的二维码

    更改网络、端口或电脑所在的局域网后,请这样做。如果只是同一网络内 IP 变了,不需要换新的二维码。

如果仍然失败

  • 状态一直停在 Connecting 或 Not connected

    • 关闭手机和电脑上的 VPN,然后重新扫描二维码。VPN 经常会隐藏电脑的局域网地址。
    • 离开访客 Wi‑Fi,改用手机和电脑可以互相访问的私有局域网。
    • 如果想在不依赖办公网络的情况下测试应用,可以让电脑加入扫描手机的热点(或把两者接入一台小型旅行路由器),然后在那里扫描二维码。
    • 在 Windows 上,请在 Private 网络下允许 Companion。被标记为 Public 的网络通常会拦截来自其他设备的入站连接。
    • 在 macOS 上,如果系统询问,请允许本地网络访问。在 Linux 上,请同时放行该端口的 TCP 和 UDP。
  • 之前能用,后来电脑地址变了

    • 不要动配对令牌。Regenerate QR 会强制所有扫描设备重新配对。
    • 只要放行了该 UDP 端口,Companion 就会广播新地址,已保存的连接也会随之更新。如果端口被拦截,请扫描一次当前的二维码。
    • 换到另一个网络(办公室与家里,或新的 VLAN)时,需要重新扫描二维码。
  • 屏幕熄灭时连接中断

    • 显示屏关闭时,扫描设备会暂停 Wi‑Fi 连接,通知中会提示连接已暂停。
    • 请在扫描设备的设置中开启 Keep screen on,或唤醒屏幕以重新连接。
    • Android 询问时请授予通知权限。没有该权限,扫描器服务无法持续运行。
  • 扫码内容留在设备上

    • 如果状态不是 Connected,扫码内容会先进入队列,重新连接后再发送,不会丢失。
    • 如果校验或计数界面处于打开状态,扫码内容会存入该会话,而不是输入到电脑。
    • 如果主屏幕上的状态是 Connected,请点击电脑上的文本字段,并确认 Type into focused window 已开启。
  • 你更改了端口

    • 端口信息包含在二维码中。请在 Companion 设置中应用新端口,然后扫描新的二维码。
    • 请同时放行该端口的 TCP 和 UDP。已经保存过此 Companion 的扫描设备会从广播中获知新端口;从未保存过的扫描设备仍会向 17832 发送信标,因此第一次配对请扫描二维码。
    • 如果端口已被其他程序占用,Companion 将无法监听。请选择 1024 以上的空闲端口。

还是解决不了?请发邮件至 office@updruck.com,并附上 Companion 版本(电脑端 Settings)、Android 应用版本(扫描设备 Settings)、在 Network 下选择的地址,以及手机是否连接了访客 Wi‑Fi 或 VPN。