適用於已在執行 QR 解碼器的 POS、自助服務機台與掃描器 SDK 團隊。這是在不變動您現有 QR 路徑的情況下，同時讀取 WIA Code 的最短途徑。
現有的 QR 路徑完全不變。WIA Code 解碼在同一影格上並行執行。
同一影格，只多一次呼叫。如果您的 QR 函式庫沒有偵測到任何內容，就將相同的 ImageData 交給 WiaScan.detectAuto()。
async function onFrame(imageData) {
// your existing decoder, unchanged:
const qr = existingQrLib.decode(imageData);
if (qr) return handleResult(qr.data);
// same frame, handed to WIA Code:
const wia = WiaScan.detectAuto(imageData, { psf: true, deep: true });
if (wia && wia.decoded) return handleResult(wia.text);
}
在本頁發布之前，這段完全相同的 detectAuto() 呼叫已針對真實的一致性測試向量（clean_square_url.png，評估套件）執行過，並正確解碼——這不是未經測試的範例程式碼。
以相同方式驗證您自己的建置：使用 node verify.js 讓參考引擎執行全部 35 組一致性測試向量 —— 評估套件 ↗。
這是軟體層面的變更，而非硬體變更——但僅適用於本身就能擷取影像的掃描器。
| 掃描器類型 | 可透過軟體升級嗎？ | 原因 |
|---|---|---|
| 以攝影機為基礎 2D 影像擷取器，手機／自助機台／網路攝影機 |
可以 | 它擷取的是真實的影像影格——與上方範例解碼的輸入完全相同。 |
| 以雷射為基礎 1D／CCD 雷射條碼掃描器 |
不可以 | 它從不擷取影像——只沿一條線測量反射雷射的強度。沒有影格可以交給 detectAuto()。 |
毫不誇張：雷射掃描器不會因韌體更新而能讀取此碼。這是感測器的物理限制，而非藍圖上的缺口。
每個 WIA Code 都帶有一個指向 wiacode.com/s.html 的小型標準 QR 補丁（booster）。任何現有的 QR 讀取器——包括您未經修改的那個——都已經能掃描該補丁，並在瀏覽器中開啟 WIA 網頁掃描器。原生整合省去的正是這多餘的一步。
| 僅 booster（未整合） | 原生解碼（本頁方案） | |
|---|---|---|
| 取得負載所需步驟 | 2 步——掃描 booster、載入頁面、再次將攝影機對準此碼 | 1 步——您自己的處理流程直接解碼 |
| 網路 | 需要——要載入一個網頁 | 不需要——完全離線 |
| 您能得到什麼 | 直接來說什麼都沒有——booster 只帶有一個固定的重新導向 URL | 在您自己的應用程式中取得完全原始的負載字串 |
| 可辨識的形狀 | 僅限內嵌的小方形補丁 | 全部 8 種已發布輪廓 |
| 解碼延遲 | 您的 QR 讀取時間，再加一次網路往返 | 單影格解碼——在參考引擎自身的除錯 HUD 上實測約為每影格 386ms |
任何通過一致性測試的人都能免費實作 WIA Code——沒有權利金，也不為任何競爭掃描器保留例外。 閱讀完整承諾並取得評估套件 ↗
執行套件後仍有疑問？ 大量核發、合作夥伴關係與商業採用方面的洽詢，請寄至同一個地址。 wiasoom@smilestory.ai
WIA Code 是 SmileStory Co., Ltd. 的產品。booster QR 只是固定的重新導向，並非負載的副本——原生整合才是您的掃描器所缺少的。