跳到主要内容

🪪 身份证自动拍摄

SDK 将泰国国民身份证拍照的整个流程自动化:在实时摄像头画面中检测证件边界,等待清晰稳定的画面,对裁剪区域进行透视校正,然后提交至泰国国民身份证 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',
});

结果对象提供类型化的访问器以及原始 OCR 响应(result.raw)——请参阅泰国国民身份证 OCR 字段参考

自动拍摄的工作原理

  • 边界检测 — 自适应 Canny 边缘检测与轮廓分析(OpenCV)在屏幕引导框内寻找符合 ID-1 证件宽高比(1.586,即 85.60 × 53.98 毫米,容差 ±0.25)的凸四边形。
  • 稳定性 — 仅当证件在最近若干帧的滑动窗口内保持稳定(角点漂移小于画面对角线的 2%)时才会触发拍摄。
  • 清晰度 — 拉普拉斯方差评分会在消耗任何积分之前拒绝模糊的画面。
  • 透视校正 — 检测到的四个角点在上传前被变换为平整的约 300 DPI 证件图像(1011 × 637 像素),可显著提升 OCR 准确率。
  • 手动兜底 — 若自动拍摄在 10 秒内未触发,将显示手动快门按钮。

了解更多