📇 官方证件自动捕捉

同一个自动捕捉引擎可以处理其他官方泰国证件：驾驶执照、银行存折 (book bank) 和带有签名的身份证副本。SDK 会检测证件边界，等待清晰稳定的帧，对裁剪进行透视校正，然后将其提交给匹配的艾艾普科技 OCR API — 每页1.0–1.25 IC，具体取决于证件类型。

支持的证件类型

DocumentType (Flutter)	documentType (Web)	调用的 API	成本
DocumentType.thaiDriverLicense	'thaiDriverLicense'	泰国驾驶执照 OCR	1.25 IC/页
DocumentType.bookBank	'bookBank'	银行存折 OCR	1.25 IC/页
DocumentType.thaiIdWithSignature	'thaiIdWithSignature'	泰国国民身份证（带签名）	1.0 IC/页

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

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

// 泰国驾驶执照
final license = await DocumentCaptureView.start(
  context,
  client: client,
  documentType: DocumentType.thaiDriverLicense,
  locale: EkycLocale.th,
);

// 银行存折
final bookBank = await DocumentCaptureView.start(
  context,
  client: client,
  documentType: DocumentType.bookBank,
);

Web

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

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

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

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

iOS / Android / React Native

相同的流程在原生封装中提供 — 一个引擎，相同的捕捉质量。安装和相机权限设置：iOS, Android & React Native。

// iOS (Swift; Objective-C 也支持)
let config = IappEkycConfig(apiKey: "YOUR_API_KEY", flow: .documentCapture)
config.documentType = .thaiDriverLicense
IappEkycSdk.present(from: self, config: config) { result in /* result.document?.rawJSON */ }

// Android (Kotlin; Java 也支持)
ekyc.launch(IappEkycRequest.DocumentCapture(config, EkycDocumentType.THAI_DRIVER_LICENSE))

// React Native
<IappEkycFlow flow="documentCapture" documentType="thaiDriverLicense" apiKey="YOUR_API_KEY"
  onResult={handleResult} onError={handleError} onCancel={close} />

自动捕捉工作原理

• 边界检测 — 自适应 Canny 边缘检测和轮廓分析 (OpenCV) 找到屏幕指南内宽高比为 1.586（容差 ±0.25）的凸四边形 — 驾驶执照、银行存折和身份证副本都具有 ID-1 几何形状。
• 稳定性 — 仅在证件在最近帧的滑动窗口内保持稳定后触发捕捉（角点漂移低于帧对角线的 2%）。
• 清晰度 — 拉普拉斯方差评分在花费任何信用之前拒绝模糊的帧。
• 透视校正 — 检测到的角点被扭曲成一个平面的约 300 DPI 图像（1011 × 637 像素），然后再上传。
• 手动备用 — 如果自动捕捉未触发，10 秒后会出现手动快门按钮。

了解更多

• 产品 API：泰国驾驶执照 · 银行存折 · 身份证（带签名）
• SDK 设置：入门
• 源代码和算法规范：github.com/iapp-technology/iapp-ekyc-sdk