条码扫描器常见问题
安装设置、扫码,以及扫描设备无法连接电脑时该检查什么。
快速入门
2D Code Scanner 能做什么?
它会把 Android 扫描设备扫到的条码,通过同一局域网发送到 Windows 或 macOS 版 Companion(Linux 为实验性支持)。Companion 会像键盘模拟输入一样,把每个条码输入到电脑上当前获得焦点的字段中。
它的工作方式像键盘模拟输入吗?
是的。Companion 会把每个条码输入到电脑上当前获得焦点的字段中,与键盘模拟输入的效果相同。你可以让它在每次扫码后附加回车键或 Tab 键。
可以用它代替 USB 条码扫描枪吗?
可以。Zebra 设备或你的手机可以取代单独的 USB 扫描枪。Companion 会在 Windows、macOS 或实验性的 Linux 上,把条码输入到当前焦点字段。
需要安装什么?
该选 Zebra 应用还是 Camera 应用?
需要账号或订阅吗?
不需要。没有云端账号,也没有订阅。条码只保存在扫描设备和电脑上,连接在你的网络内通过 AES-256-GCM 加密。
配对
如何将扫描设备与电脑配对?
- 打开 Companion。如果窗口被隐藏,它可能还在系统托盘里。
- 让扫描设备和电脑连接到同一个局域网。
- 在 Zebra 设备上,对准二维码并按下硬件扳机键。在 Camera 应用中,点按 Scan。
- 扫描设备上应显示 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 会被拒绝连接,更新电脑端应用后才能重新连接。
扫码
设备上显示了条码,但电脑上没有任何输入
如何在每次扫码后发送回车键或 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 或防火墙拦截了设备之间的流量,也仍然可能连不上电脑。
请按顺序检查
- Companion 确实在运行
开启 Close to tray 后,关闭窗口只会把它隐藏到系统托盘,仍会接受扫描设备的连接。点击托盘图标上的 Quit 才会退出。
- 两台设备在同一个局域网内
扫描设备使用 Wi‑Fi。电脑可以连接同一个 Wi‑Fi,也可以通过以太网接入同一局域网。访客网络、公共热点以及开启了客户端隔离的接入点,即使双方都能上网,设备之间也互相看不到。
- 二维码使用的是扫描设备能访问的地址
Companion 的 Settings → Network 会列出电脑的局域网地址。请选择办公室 Wi‑Fi 或以太网的地址(通常以
192.168…或10…开头)。不要选择 VPN、虚拟机和虚拟化平台的适配器。也可以使用 Connection Wizard —— 推荐的适配器带有标记,当 Connections 打开或欢迎流程处于连接步骤时,你的扫描设备会出现在列表中。更改后请重新扫描二维码。 - 防火墙已放行 Companion
允许入站 TCP 和 UDP 17832(或你在 Settings → Port 中设置的端口)。TCP 负责承载连接;同一端口上的 UDP 则让已保存的扫描设备在 DHCP 改变电脑地址后找到新地址,也让 Companion 能在 Connection Wizard 中看到扫描设备。
- 扫描当前的二维码
更改网络、端口或电脑所在的局域网后,请这样做。如果只是同一网络内 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。