人脸比对

SDK 以一次类型化调用封装人脸比对 API：传入两张人脸图像，例如主动活体检测得到的自拍和从采集的身份证裁出的人像，即可得到相似度得分与是否匹配的判定，每次请求 0.3 IC。此调用不含摄像头界面。

调用

Flutter

import 'package:iapp_ekyc_sdk/iapp_ekyc_sdk.dart';

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

final result = await client.verifyFaces(
  file1: selfieBytes,   // e.g. from ActiveLivenessView
  file2: idFaceBytes,   // e.g. from DocumentCaptureView
);

if (result.matched) {
  // 同一个人 — 更多详情请参阅 result.raw 中的得分与阈值
}

Web

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

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

const result = await ekyc.verifyFaces({
  file1: selfieBlob,
  file2: idFaceBlob,
});

if (result.matched) {
  // 同一个人
}

iOS / Android / React Native

原生封装通过 faceCapture 流程自动拍摄清晰的正脸自拍；请从您的应用或后端把返回的 JPEG 提交给此 API。如需防伪的端到端流程，请使用主动人脸活体检测，其签名判定已包含被动活体检测。

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

结果

result.matched 表示两张人脸是否为同一人；得分及判定所用的阈值在 result.raw 中。默认阈值的精度为 99.50%；提高阈值可降低误接受率，详见 API 参考。

数据处理与重试

• 图像只保留在内存中，且只发送到配置的 baseUrl；SDK 从不将其写入磁盘。
• 这是计费调用：请求正文发出后，SDK 不会自动重试。

本 SDK 为开源项目：github.com/iapp-technology/iapp-ekyc-sdk。