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

เว็บ​

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

ผลลัพธ์มีทั้ง accessor แบบระบุชนิดข้อมูลและการตอบกลับ OCR แบบดิบ (result.raw) — ดู ข้อมูลอ้างอิงฟิลด์ของ Thai National ID Card OCR

การถ่ายภาพอัตโนมัติทำงานอย่างไร​

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

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