Kho kiểm thử công khai
Các tuyên bố về tương thích máy quét của chúng tôi chỉ đáng tin cậy bằng bằng chứng làm nền tảng. Trang này là corpus, các đầu vào chuẩn mà chúng tôi chạy kiểm tra hồi quy trên mọi encoder, cộng với hành vi camera điện thoại mà bạn có thể tự kiểm tra mà không cần tin vào lời chúng tôi.
Tải xuống corpus.zip Gói fixtures JSON + CSV + phương pháp + README. ~4 KB.
Đang tải phiên bản…
Cách sử dụng corpus
Mỗi vector kiểm tra nằm trong /test-vectors/fixtures.json. Một đối tượng JSON mỗi loại với các trường đầu vào và substring giải mã dự kiến. Lấy trực tiếp từ trang này, không có bản sao lỗi thời.
Lấy bản đồ fields của bất kỳ fixture nào, nhập các giá trị vào bộ tạo cho loại đó, và nhấn Tạo. QR kết quả giống từng bit với những gì CI của chúng tôi dùng để kiểm tra vòng lặp.
Hướng iPhone Camera, Android Camera, Google Lens, máy quét công nghiệp (Zebra, Honeywell, Datalogic), hoặc thiết bị đọc dành cho ứng dụng (ứng dụng ngân hàng, ứng dụng xác thực) vào QR đã tạo. Xác nhận văn bản được giải mã có chứa mọi substring expect cho fixture đó.
Nếu máy quét trong đội của bạn trả về kết quả giải mã không khớp với fixture, hãy tạo báo cáo lỗi. Chúng tôi sẽ tái hiện, thêm máy quét của bạn vào ma trận tương thích công khai, và (nếu là lỗi encoder) gửi bản sửa lỗi.
Kết quả quét dự kiến, tập hợp con được tuyển chọn
Đây là chế độ xem gọn của fixture JSON đầy đủ, được nhóm theo hành vi máy quét. Để có danh sách đầy đủ tất cả các loại mà Abundera hỗ trợ, hãy truy cập /test-vectors/.
| Loại | Đầu vào fixture | iOS Camera | Android Camera | Máy quét chuyên nghiệp |
|---|---|---|---|---|
| URL | https://example.com/test | Giải mã được | Giải mã được | Giải mã được |
| WiFi | SSID=MyNet PSK=... WPA | Kết nối mạng | Kết nối mạng | Giải mã payload |
| WiFi Enterprise (EAP) | WPA2-EAP PEAP identity=alice@corp | iOS 17+ | Giải mã được | Giải mã được |
| vCard | FN=Alice ORG=Acme ... | Thêm vào Danh bạ | Thêm vào Danh bạ | Giải mã payload |
| TOTP | otpauth://totp/...?secret=JBSW... | Ứng dụng xác thực đọc được | Ứng dụng xác thực đọc được | Giải mã URI |
| eSIM | LPA:1$rsp.example.com$K2-LM... | iOS 17.4+ cấp phát | Android 13+ cấp phát | Giải mã URI |
| Bitcoin (BIP-21) | bitcoin:1A1zP1eP... | Ứng dụng ví mở | Ứng dụng ví mở | Giải mã URI |
| SEPA (EPC) | BCD header + name + IBAN + amount | Chỉ chuỗi thô | Chỉ chuỗi thô | Hỗ trợ ứng dụng ngân hàng |
| Swiss QR-bill | SPC header + IBAN + address + amount | Chỉ chuỗi thô | Chỉ chuỗi thô | Ứng dụng ngân hàng Thụy Sĩ hỗ trợ gốc |
| GS1 Digital Link | https://id.gs1.org/01/09506000134352 | Mở URL | Mở URL | Firmware POS phân tích AI |
| Data Matrix | Arbitrary payload | Không giải mã được | Chỉ Google Lens | Gốc |
| Aztec | Arbitrary payload | Không giải mã được | Một số thiết bị đọc Android | Gốc |
| PDF417 | AAMVA or arbitrary | Không giải mã được | Google Lens một phần | Gốc |
| AAMVA driver license | @\n\x1e\rANSI 636014080002DL... | iOS 17+ nhận dạng bằng lái | Ứng dụng Android nhận dạng bằng lái | Gốc |
| EAN-13 | 0012345678905 | Giải mã chữ số | Giải mã chữ số | Mọi POS bán lẻ |
| Code 128 | ABC-123 | Giải mã được | Giải mã được | Gốc |
| Micro QR | Compact payload | Không giải mã được | Không giải mã được | Chỉ thiết bị đọc công nghiệp |
| rMQR | Rectangular payload | Không giải mã được | Không giải mã được | Một số firmware Scandit/Cognex |
Ý nghĩa của "kết quả quét dự kiến"
- Giải mã được, thiết bị đọc camera gốc của điện thoại trả về payload mà không cần ứng dụng riêng.
- Một phần, việc giải mã phụ thuộc vào một ứng dụng cụ thể (xác thực, ví, ngân hàng) hoặc phiên bản hệ điều hành cụ thể.
- Không giải mã được, camera gốc không trả về gì. Cần máy quét hoặc thiết bị đọc chuyên dụng.
Ghi chú phương pháp
- Mỗi fixture đều qua vòng lặp đầy đủ. CI của chúng tôi tạo từng mã trong Chromium không có giao diện, giải mã lại qua API
BarcodeDetectorcủa trình duyệt, và kiểm tra kết quả khớp substring. CI xanh có nghĩa là corpus nhất quán nội bộ. - Kết quả máy quét trong bảng này từ kiểm tra thủ công trên thiết bị thực. Không được tổng hợp. iPhone 15 Pro trên iOS 18.3, Pixel 8 trên Android 14, Zebra DS8100 imager trên firmware CAAACS00-002-R06.
- Chúng tôi công bố kết quả tiêu cực. Nếu iPhone Camera từ chối giải mã một ký hiệu học (Data Matrix, Aztec, PDF417), đó là "Không giải mã được" trong bảng, không đổi tên thành "thiết bị đọc gốc".
- Corpus được phiên bản hóa. Khi chúng tôi thêm loại hoặc sửa lỗi encoder, mục fixture tương ứng được gửi trong cùng commit. Kiểm tra lịch sử fixture để theo dõi kiểm toán.
Sắp ra mắt
- Artifacts được render trước. ZIP hiện tại gộp fixtures + phương pháp + CSV. Phiên bản tương lai sẽ thêm SVG + PNG được render trước của từng fixture để bạn có thể đưa thẳng vào harness kiểm tra đội máy quét. Đang chờ bước trình duyệt không có giao diện tại thời điểm build.
- Chứng nhận đội máy quét. Nhật ký có ngày tại docs/SCANNER_ATTESTATION.md, tăng mỗi lần chúng tôi xác minh với thiết bị mới.
- Xác minh bên thứ ba. Một phòng thí nghiệm bảo mật độc lập chạy corpus qua đội máy quét và công bố chứng nhận có chữ ký. Đang chờ, đã đặt hàng; báo cáo sẽ được công bố tại đây khi có.
Xem thêm
- /test-vectors/, fixture JSON đầy đủ và bảng có thể tìm kiếm.
- /compatibility/, ma trận tương thích máy quét trực tiếp.
- /standards/, trang tham khảo theo từng tiêu chuẩn.
- /print-size/, hướng dẫn in vật lý đi kèm corpus.