Skip to main content

🪪 การจับภาพบัตรประชาชนอัตโนมัติ

SDK ช่วยให้กระบวนการถ่ายภาพบัตรประจำตัวประชาชนไทยทั้งหมดเป็นไปโดยอัตโนมัติ: ตรวจจับขอบเขตบัตรในฟีดกล้องสด, รอเฟรมที่คมชัดและเสถียร, แก้ไขมุมมองของภาพที่ครอบตัด, และส่งไปยัง Thai National ID Card OCR API — 1.25 IC สำหรับด้านหน้า, 0.75 IC สำหรับด้านหลัง ไม่ต้องจัดกรอบด้วยตนเอง ไม่ต้องถ่ายใหม่เพราะภาพเบลอ

Flutter​

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

final client = IappEkycClient(apiKey: 'YOUR_API_KEY');

// ด้านหน้า
final front = await DocumentCaptureView.start(
  context,
  client: client,
  documentType: DocumentType.thaiIdFront,
  locale: EkycLocale.th,
);

// ด้านหลัง (รหัสเลเซอร์)
final back = await DocumentCaptureView.start(
  context,
  client: client,
  documentType: DocumentType.thaiIdBack,
);

Web​

import { IappEkyc } from '@iapp-technology/ekyc-sdk';

const ekyc = new IappEkyc({ apiKey: 'YOUR_API_KEY' });

const front = await ekyc.captureDocument({
  mount: document.getElementById('ekyc-mount'),
  documentType: 'thaiIdFront',
  locale: 'th',
});

const back = await ekyc.captureDocument({
  mount: document.getElementById('ekyc-mount'),
  documentType: 'thaiIdBack',
});

ผลลัพธ์จะแสดงตัวเข้าถึงข้อมูลแบบ typed และการตอบสนอง OCR ดิบ (result.raw) — ดู Thai National ID Card OCR field reference

iOS / Android / React Native​

กระบวนการเดียวกันนี้มีอยู่ใน wrapper ดั้งเดิม — เครื่องมือเดียว คุณภาพการจับภาพเหมือนกัน การติดตั้งและการตั้งค่าการอนุญาตเข้าถึงกล้อง: iOS, Android & React Native

// iOS (Swift; Objective-C ก็รองรับ)
let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .documentCapture)
config.documentType = .thaiIdFront
IappEkycSdk.present(from: self, config: config) { result in /* result.document?.rawJSON */ }
// Android (Kotlin; Java ก็รองรับ)
ekyc.launch(IappEkycRequest.DocumentCapture(config, EkycDocumentType.THAI_ID_FRONT))
// React Native
<IappEkycFlow flow="documentCapture" documentType="thaiIdFront" apiKey="YOUR_API_KEY"
  onResult={handleResult} onError={handleError} onCancel={close} />

วิธีการทำงานของการจับภาพอัตโนมัติ​

  • การตรวจจับขอบเขต — การตรวจจับขอบ Canny แบบปรับได้และการวิเคราะห์รูปทรง (OpenCV) ค้นหารูปสี่เหลี่ยมขนมเปียกปูนที่ตรงกับอัตราส่วนของบัตร ID-1 (1.586, หรือ 85.60 × 53.98 มม., ±0.25 tolerance) ภายในแนวที่แสดงบนหน้าจอ
  • ความเสถียร — การจับภาพจะทำงานก็ต่อเมื่อบัตรมีความเสถียรในช่วงหน้าต่างเลื่อนของเฟรมล่าสุด (มุมเคลื่อนที่น้อยกว่า 2% ของแนวทแยงของเฟรม)
  • ความคมชัด — การให้คะแนน Laplacian-variance จะปฏิเสธเฟรมที่เบลอก่อนที่จะใช้เครดิตใดๆ
  • การแก้ไขมุมมอง — มุมที่ตรวจพบจะถูกบิดให้เป็นภาพบัตรแบนราบประมาณ 300 DPI (1011 × 637 px) ก่อนที่จะอัปโหลด ซึ่งช่วยปรับปรุงความแม่นยำของ OCR ได้อย่างเห็นได้ชัด
  • การสำรองข้อมูลด้วยตนเอง — ปุ่มชัตเตอร์แบบแมนนวลจะปรากฏขึ้นหลังจาก 10 วินาที หากการจับภาพอัตโนมัติยังไม่ทำงาน

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