條碼掃描器常見問題
設定、掃描,以及掃描器無法連上電腦時該檢查哪些項目。
快速入門
2D Code Scanner 能做什麼?
它會把 Android 掃描器掃到的條碼,透過同一個區域網路傳送到 Windows 或 macOS 版 Companion(Linux 為實驗性支援)。Companion 會像鍵盤模擬輸入一樣,把每個條碼輸入到電腦上目前取得焦點的欄位中。
它的運作方式像鍵盤模擬輸入嗎?
是的。Companion 會把每個條碼輸入到電腦上目前取得焦點的欄位中,與鍵盤模擬輸入的效果相同。你可以在每次掃描後加上 Enter 或 Tab。
可以用它取代 USB 條碼掃描器嗎?
可以。Zebra 裝置或你的手機可以取代獨立的 USB 掃描器。Companion 會在 Windows、macOS 或實驗性的 Linux 上,把條碼輸入到焦點所在的欄位。
需要安裝哪些軟體?
該選 Zebra 應用程式還是 Camera 應用程式?
需要帳號或訂閱嗎?
不需要。沒有雲端帳號,也沒有訂閱。條碼只會留在掃描器和電腦上,連線在你的網路內以 AES-256-GCM 加密。
配對
如何將掃描器與電腦配對?
- 開啟 Companion。如果視窗被隱藏,它可能還在系統匣中。
- 讓掃描器和電腦連上同一個區域網路。
- 在 Zebra 裝置上,對準 QR 碼並按下硬體扳機鍵。在 Camera 應用程式中,請點選 Scan。
- 掃描器上應顯示 Connected。
如果電腦有多張網路卡,請開啟 Companion 的 Settings → Connection Wizard(或首頁上的 Connection Wizard 連結)。精靈會推薦區域網路位址、協助處理防火牆,並列出你在裝置上開啟 Connections 時出現的掃描器。你也可以在掃描 QR 碼之前,手動將 Network 設為掃描器能夠連到的位址。
每次都要重新配對嗎?
不需要。配對資訊會儲存在掃描器的 Connections 中(點選主畫面上的連線狀態列即可)。結束並重新開啟 Companion 後,它仍會使用相同的配對權杖,掃描器會自動重新連線。
如果電腦在同一網路內的位址變更,Companion 會廣播新位址,已儲存的連線也會隨之更新。只有在電腦換到不同網路,或你重新產生 QR 碼時,才需要再次掃描 QR 碼。
可以使用多台電腦嗎?
可以。掃描各個 Companion 的 QR 碼即可儲存。你可以在 Connections 中為連線命名、切換目前使用的連線,或將其刪除。
「重新產生 QR 碼」有什麼作用?
它會建立新的配對權杖,並中斷所有掃描器的連線。每台裝置都必須掃描新的 QR 碼才能再次連線。當你想讓舊的配對失效時才使用它;如果只是 IP 位址變了,不需要這麼做。
掃描器提示 Companion 版本過舊
請從下載頁面安裝 Companion 1.1.0 或更新版本,或在 Companion 設定中使用 Check for updates。版本過舊的 Companion 會被拒絕,必須更新電腦端應用程式後才能重新連線。
掃描
裝置上顯示了條碼,但電腦上沒有任何輸入
如何在每次掃描後傳送 Enter 或 Tab?
在掃描器上開啟 Settings,並將 After each scan 設為 Enter、Tab 或無。預設為 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 中啟用。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,也可以透過乙太網路接入同一個區域網路。訪客網路、公共熱點,以及啟用用戶端隔離的無線基地台,即使雙方都能上網,裝置之間也看不到彼此。
- QR 碼使用的是掃描器能連到的位址
Companion 的 Settings → Network 會列出電腦的區域網路位址。請選擇辦公室 Wi‑Fi 或乙太網路的位址(通常以
192.168…或10…開頭)。請略過 VPN、虛擬機器與 Hypervisor 的網路卡。也可以使用 Connection Wizard —— 推薦的網路卡會有標示,當 Connections 開啟,或歡迎流程停在連線步驟時,你的掃描器會出現在清單中。變更後請重新掃描 QR 碼。 - 防火牆已允許 Companion
請允許輸入 TCP 和 UDP 17832(或你在 Settings → Port 中設定的連接埠)。TCP 負責承載連線;同一連接埠上的 UDP,則讓已儲存的掃描器在 DHCP 更改電腦位址後找到新位址,也讓 Companion 能在 Connection Wizard 中看到掃描器。
- 掃描目前的 QR 碼
變更網路、連接埠或電腦所在的區域網路後,請這麼做。如果只是同一網路內 IP 變了,不需要換新的 QR 碼。
如果仍然失敗
狀態一直停在 Connecting 或 Not connected
- 關閉手機和電腦上的 VPN,然後重新掃描 QR 碼。VPN 常會隱藏電腦的區域網路位址。
- 離開訪客 Wi‑Fi,改用手機與電腦可以互相連線的私人區域網路。
- 如果想在不依賴辦公室網路的情況下測試應用程式,可以讓電腦加入掃描手機的熱點(或將兩者接上一台小型旅行路由器),並在那裡掃描 QR 碼。
- 在 Windows 上,請在 Private 網路下允許 Companion。被標示為 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。