官方证件自动采集

身份证的自动采集同样适用于泰国驾驶执照、银行存折（book bank）和带签名的身份证副本，并把每种证件提交给对应的 OCR API，每页 1.25 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

// 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

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

React Native

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

安装：Flutter 与 Web 见入门指南，原生封装与相机权限见 iOS, Android & React Native。

选项

documentType 决定证件类型及其提交的 API：

证件	Flutter	Web	API
驾驶执照	DocumentType.thaiDriverLicense	'thaiDriverLicense'	泰国驾驶执照 OCR
银行存折	DocumentType.bookBank	'bookBank'	银行存折 OCR
带签名的身份证副本	DocumentType.thaiIdWithSignature	'thaiIdWithSignature'	泰国国民身份证（带签名）

locale 设置界面语言：en、th 或 zh（Flutter 中为 EkycLocale.th）。

结果

结果包含类型化字段，以及 result.raw 中的原始 OCR 响应（iOS 上为 result.document?.rawJSON）。字段列表见上表中各 API 的页面。

自动采集如何工作

• 边界：在屏幕引导框内寻找宽高比符合 ID-1 卡片 1.586 的四边形，容差 ±0.25。驾驶执照、银行存折和身份证副本均为 ID-1 尺寸。
• 稳定：证件须在最近多帧中保持稳定，角点漂移小于画面对角线的 2%。
• 清晰度：模糊帧会在消耗任何额度之前被剔除。
• 透视校正：上传前将角点拉平为约 300 DPI 的平整图像（1011 × 637 像素）。
• 手动拍摄：若 10 秒后仍未自动拍摄，会出现手动快门按钮。

完整的算法规范见 SDK 源代码。