🛂 护照自动拍摄

SDK 自动完成护照资料页（带照片和机读区的那一页）的拍摄：在实时摄像头画面中检测页面边界，等待清晰稳定的画面，对裁剪区域进行透视校正，然后提交至护照 OCR API——每次请求 0.75 IC。它与身份证使用同一套自动拍摄引擎，只是针对更大的 ID-3 护照尺寸进行了调优。

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

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

final result = await DocumentCaptureView.start(
  context,
  client: client,
  documentType: DocumentType.passport,
  locale: EkycLocale.en,
);

网页

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

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

const result = await ekyc.captureDocument({
  mount: document.getElementById('ekyc-mount'),
  documentType: 'passport',
  locale: 'en',
});

结果对象提供类型化的访问器以及原始 OCR 响应（result.raw），包括已解析的 MRZ 字段——请参阅护照 OCR 字段参考。

自动拍摄的工作原理

• 边界检测 — 自适应 Canny 边缘检测与轮廓分析（OpenCV）在屏幕引导框内寻找符合 ID-3 护照资料页宽高比（1.42，即 125 × 88 毫米，容差 ±0.25）的凸四边形。
• 稳定性 — 仅当页面在最近若干帧的滑动窗口内保持稳定（角点漂移小于画面对角线的 2%）时才会触发拍摄。
• 清晰度 — 拉普拉斯方差评分会拒绝模糊的画面，在消耗任何积分之前保护精细的 MRZ 印刷文字免受运动模糊影响。
• 透视校正 — 检测到的四个角点在上传前被变换为平整的约 300 DPI 页面图像（1476 × 1039 像素）。
• 手动兜底 — 若自动拍摄在 10 秒内未触发，将显示手动快门按钮。

了解更多

• 产品 API：护照 OCR
• SDK 设置：入门指南
• 源代码与算法规范：github.com/iapp-technology/iapp-ekyc-sdk