การจับภาพหนังสือเดินทางอัตโนมัติ
SDK ทำงานอัตโนมัติในการจับภาพหน้าข้อมูลหนังสือเดินทาง (หน้าที่มีรูปถ่ายและโซนที่อ่านด้วยเครื่องได้): ตรวจจับขอบเขตของหน้าในฟีดกล้องสด, รอเฟรมที่คมชัดและเสถียร, ปรับมุมมองของส่วนที่ตัดออก, และส่งไปยัง Passport OCR API — 0.75 IC ต่อคำขอ เป็นกลไกการจับภาพอัตโนม ัติเดียวกันกับบัตรประจำตัวประชาชน ปรับให้เหมาะกับรูปทรงหนังสือเดินทาง ID-3 ที่ใหญ่กว่า
Flutter
import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';
final client = IappEkycClient(apiKey: 'YOUR_API_KEY');
final result = await DocumentCaptureView.start(
context,
client: client,
documentType: DocumentType.passport,
locale: EkycLocale.en,
);
Web
import { IappEkyc } from '@iapp-technology/ekyc-sdk';
const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });
const result = await ekyc.captureDocument({
mount: document.getElementById('ekyc-mount'),
documentType: 'passport',
locale: 'en',
});
ผลลัพธ์จะเปิดเผยตัวเข้าถึงแบบพิมพ์พร้อมกับการตอบสนอง OCR ดิบ (result.raw) รวมถึงฟิลด์ MRZ ที่แยกวิเคราะห์แล้ว — ดูที่ เอกสารอ้างอิงฟิลด์ Passport OCR
iOS / Android / React Native
ขั้นตอนเดียวกันนี้มีอยู่ใน Wrapper ดั้งเดิม — กลไกเดี ยว คุณภาพการจับภาพเหมือนกัน การติดตั้งและการตั้งค่าสิทธิ์กล้อง: iOS, Android & React Native
// iOS (Swift; Objective-C ก็รองรับ)
let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .documentCapture)
config.documentType = .passport
IappEkycSdk.present(from: self, config: config) { result in /* result.document?.rawJSON */ }
// Android (Kotlin; Java ก็รองรับ)
ekyc.launch(IappEkycRequest.DocumentCapture(config, EkycDocumentType.PASSPORT))
// React Native
<IappEkycFlow flow="documentCapture" documentType="passport" apiKey="YOUR_API_KEY"
onResult={handleResult} onError={handleError} onCancel={close} />
การทำงานของการจับภาพอัตโนมัติ
- การตรวจจับขอบเขต — การตรวจจับขอบ Canny แบบปรับได้และการวิเคราะห์เส้นขอบ (OpenCV) เพื่อค้นหารูปสี่เหลี่ยมที่มีมุมนูนซึ่งตรงกับอัตราส่วนภาพของหน้าข้อมูลหนังสือเดินทาง ID-3 (1.42 คือ 125 × 88 มม. ±0.25 ความคลาดเคลื่อน) ภายในไกด์บนหน้าจอ
- ความเสถียร — การจับภาพจะทำงานก็ต ่อเมื่อหน้าได้นิ่งในหน้าต่างเลื่อนของเฟรมล่าสุด (มุมเบี่ยงเบนน้อยกว่า 2% ของแนวทแยงของเฟรม)
- ความคมชัด — การให้คะแนนความแปรปรวนของ Laplacian จะปฏิเสธเฟรมที่เบลอ ป้องกันรายละเอียดการพิมพ์ MRZ จากการเบลอจากการเคลื่อนไหว ก่อนที่เครดิตจะถูกใช้
- การแก้ไขมุมมอง — มุมที่ตรวจพบจะถูกบิดเพื่อให้ได้ภาพหน้าเรียบ ~300 DPI (1476 × 1039 px) ก่อนอัปโหลด
- การแก้ไขด้วยตนเอง — ปุ่มชัตเตอร์ด้วยตนเองจะปรากฏขึ้นหลังจาก 10 วินาที หากการจับภาพอัตโนมัติยังไม่ทำงาน
เรียนรู้เพิ่มเติม
- Product API: Passport OCR
- การตั้งค่า SDK: เริ่มต้นใช้งาน
- ที่มาและข้อกำหนดอัลกอริทึม: github.com/iapp-technology/iapp-ekyc-sdk