Dành cho các đội POS, kiosk và scanner SDK đã chạy sẵn một bộ giải mã QR. Đây là con đường ngắn nhất để đọc WIA Code song song với nó — mà không cần đụng đến luồng QR bạn đã triển khai.
Luồng QR hiện có không bị đụng chạm. Việc giải mã WIA Code chạy song song với nó, trên cùng một khung hình.
Cùng một khung hình, thêm một lệnh gọi. Nếu thư viện QR của bạn không tìm thấy gì, hãy đưa cùng ImageData đó cho 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);
}
Chính lệnh gọi detectAuto() này đã được chạy thử với một vector kiểm tra tuân thủ thực tế (clean_square_url.png, bộ đánh giá) trước khi trang này được xuất bản, và đã giải mã đúng — đây không phải là mã mẫu chưa được kiểm thử.
Hãy xác minh bản build của riêng bạn theo cách tương tự: chạy công cụ tham chiếu trên toàn bộ 35 vector kiểm tra tuân thủ bằng node verify.js — bộ đánh giá ↗.
Đây là một thay đổi phần mềm, không phải phần cứng — nhưng chỉ áp dụng cho các máy quét vốn đã chụp được hình ảnh.
| loại máy quét | có thể nâng cấp bằng phần mềm không? | lý do |
|---|---|---|
| Dựa trên camera bộ tạo ảnh 2D, điện thoại/kiosk/webcam |
Có | Nó chụp một khung hình ảnh thực — đầu vào giống hệt như ví dụ ở trên giải mã. |
| Dựa trên laser máy quét mã vạch laser 1D/CCD |
Không | Nó không bao giờ chụp hình ảnh — nó chỉ đo cường độ laser phản xạ dọc theo một đường thẳng. Không có khung hình nào để đưa cho detectAuto(). |
Không hề phóng đại: một máy quét laser sẽ không đọc được cái này dù có cập nhật firmware. Đó là giới hạn vật lý của cảm biến, không phải một thiếu sót trong lộ trình phát triển.
Mỗi WIA Code đều mang theo một miếng vá QR chuẩn nhỏ (booster) trỏ đến wiacode.com/s.html. Bất kỳ đầu đọc QR hiện có nào — kể cả của bạn, không cần sửa đổi — đã có thể quét miếng vá đó và truy cập vào máy quét web của WIA trên trình duyệt. Tích hợp gốc (native) chính là thứ loại bỏ bước phụ đó.
| chỉ có booster (chưa tích hợp) | giải mã gốc (trang này) | |
|---|---|---|
| các bước để lấy payload | 2 — quét booster, tải trang, hướng camera vào mã một lần nữa | 1 — pipeline của riêng bạn giải mã trực tiếp |
| mạng | cần thiết — nó tải một trang web | không cần — hoàn toàn ngoại tuyến |
| những gì bạn nhận được | không có gì trực tiếp — booster chỉ mang một URL chuyển hướng cố định | chuỗi payload gốc chính xác, ngay trong ứng dụng của riêng bạn |
| các hình dạng được nhận diện | chỉ miếng vá hình vuông nhỏ được nhúng | toàn bộ 8 hình dạng (silhouette) đã công bố |
| độ trễ giải mã | lần đọc QR của bạn, cộng thêm một vòng round trip qua mạng | giải mã trong một khung hình — khoảng 386ms mỗi khung hình, đo trên chính HUD gỡ lỗi của công cụ tham chiếu |
Việc triển khai WIA Code miễn phí cho tất cả những ai vượt qua bài kiểm tra tuân thủ — không có tiền bản quyền, không có ngoại lệ dành riêng cho máy quét cạnh tranh. Đọc toàn bộ cam kết và nhận bộ đánh giá ↗
Có thắc mắc sau khi chạy thử bộ công cụ? Các yêu cầu về phát hành hàng loạt, hợp tác và áp dụng thương mại đều gửi đến cùng một địa chỉ. wiasoom@smilestory.ai
WIA Code là sản phẩm của Công ty TNHH SmileStory. Booster QR là một chuyển hướng cố định, không phải bản sao của payload — tích hợp gốc (native) chính là điều mà máy quét của bạn còn thiếu.