Skip to main content

🛂 ถ่ายภาพหนังสือเดินทางอัตโนมัติ

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,
);

เว็บ​

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',
});

ผลลัพธ์มีทั้ง accessor แบบระบุชนิดข้อมูลและการตอบกลับ OCR แบบดิบ (result.raw) รวมถึงฟิลด์ MRZ ที่ผ่านการแยกวิเคราะห์แล้ว — ดู ข้อมูลอ้างอิงฟิลด์ของ Passport OCR

iOS / Android / React Native​

โฟลว์เดียวกันนี้พร้อมใช้งานในแรปเปอร์เนทีฟ — เอนจินเดียวกัน คุณภาพการถ่ายภาพเท่ากันทุกแพลตฟอร์ม วิธีติดตั้งและการตั้งค่าสิทธิ์กล้อง: iOS, Android และ React Native

// iOS (Swift; Objective-C also supported)
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 also supported)
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 variance จะปฏิเสธเฟรมที่เบลอ เพื่อปกป้องตัวพิมพ์ MRZ ที่ละเอียดจากภาพเบลอจากการเคลื่อนไหว ก่อนที่จะมีการใช้เครดิตใดๆ
  • การแก้ไขมุมมองภาพ — มุมที่ตรวจพบจะถูกแปลงเป็นภาพหน้าเอกสารแบนราบที่ความละเอียดประมาณ 300 DPI (1476 × 1039 พิกเซล) ก่อนอัปโหลด
  • โหมดสำรองแบบแมนนวล — ปุ่มชัตเตอร์แบบแมนนวลจะปรากฏขึ้นหลังจาก 10 วินาที หากการถ่ายภาพอัตโนมัติยังไม่ทำงาน

เรียนรู้เพิ่มเติม​