Flutter人脸识别验证插件facedapter_idv的使用

Facedapter IDV Onboarding Flutter SDK

一个提供快速、安全和准确的身份验证SDK。

示例

要运行示例项目，请克隆仓库，设置你的API密钥，然后在Example目录下运行以下命令：

cd example/
flutter run

Demo

在线演示：联系我们获取演示

功能

安全特性：

• 移动智能欺诈检测（Shield）
• 面部活体检测和照片/视频欺骗攻击检测
• 快速准确的身份证扫描
• 准确的身份证照片和自拍匹配

安全和快速：

• 身份验证SDK非常快，在不到10秒内即可完成，并提供大量数据供智能决策

更好的用户体验：

• 清晰简单的用户界面
• 无需等待，快速检测和身份验证（<10秒）

SDK集成

安装

facedapter_idv 可通过 pub.dev 获取。要安装它，请将 facedapter_idv 依赖项添加到你的 pubspec.yaml 文件中：

dependencies:
  ...
  facedapter_idv:

执行首次身份验证

初始化SDK

首先，你需要从Facedapter仪表板获取API密钥。在视图控制器中初始化SDK时，需要传入API密钥。

class _MyAppState extends State<MyApp> {
  final FacedapterIdvPlugin = FacedapterIdv();

  @override
  void initState() {
    super.initState();
    initialize();
  }

  Future<void> initialize() async {
    await FacedapterIdvPlugin.initialize("YOUR_API_KEY");
  }

  // 在视图控制器中调用此方法开始身份验证。
  Future<void> startOnboarding() async {
    Map<dynamic, dynamic> result = {};

    try {
      result = await FacedapterIdvPlugin.startOnboarding() ?? {};
      print(result);
    } on PlatformException {
      // 处理异常
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Facedapter IDV Onboarding'),
        ),
        body: Center(
          child: TextButton(
            style: TextButton.styleFrom(
              textStyle: const TextStyle(fontSize: 20),
            ),
            onPressed: startOnboarding,
            child: const Text('启动SDK'),
          ),
        )
      ),
    );
  }
}

最大尝试次数选项

你可以通过向initialize函数传递第二个参数来限制用户可以进行的身份验证尝试次数。

例如，使用值2，当用户达到2次不成功的身份验证尝试后，身份验证将结束：

await FacedapterIdvPlugin.initialize("YOUR_API_KEY", 2);

如果使用了最大尝试次数选项，并且身份验证成功，它将返回预期的结果对象。但如果失败，则会返回带有值MAX_ATTEMPTS的reasonCode。

Future<void> startOnboarding() async {
  Map<dynamic, dynamic> result = {};

  try {
    result = await FacedapterIdvPlugin.startOnboarding() ?? {};
    print(result.reasonCode);
    // 如果用户达到最大尝试次数而未成功身份验证，将返回原因码。
    // 输出为："MAX_ATTEMPTS"
  } on PlatformException {
    // 处理异常
  }
}

平台特定实现

插件实现位于lib文件夹中，而平台特定实现位于android和ios文件夹中。

Android

安装后，Android文件夹将完全初始化。

iOS

1. 在添加了对facedapter_idv的依赖项到pubspec.yaml后，转到NameOfYourProject/ios并运行pod install。 我们的facedapter_idv依赖项将自动安装。

2. 添加描述到你的Info.plist以支持iOS，打开NameOfYourProject/ios/Runner.xcworkspace并在NameOfYourProject/ios/Runner/Info.plist中设置以下键：

   • NSCameraUsageDescription
   • NSMicrophoneUsageDescription
   • NSPhotoLibraryAddUsageDescription
   • NSLocationWhenInUseUsageDescription

身份验证结果

所有身份验证结果都可用作映射对象。

{
    'userInfo': {
        'firstName': '...',
        'lastName': '...',
        'email': '...',
        'phoneModel': '...',
        'actionDuration': 10, // 秒
        'totalDuration': 20 // 秒
    },
    'location': {
        'latitude': 1.12345678,
        'longitude': 1.12345678,
        'accuracy': 16.399999618530273,
        'altitude': 10.899999618530273
    },
    'address': {
        'country': 'Switzerland',
        'city': 'Geneva',
        'countryCode': 'CH'
    },
    'shield': {
        'device_intelligence': {
            'app_tampering': false,
            'device_score': 115,
            'hooking': false,
            'is_emulated': false,
            'is_jailbroken': false,
            'running_clone_apps': false,
            'running_gps_spoofers': false,
            'running_vpn_spoofers': false,
            'shield_id': 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx',
            'suspicious_factory_reset': false,
            'virtual_os': false
        },
        'platform': 'Android',
        'session_id': 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx',
        'timestamp': '1646876268',
        'version': '1.1.0'
    },
    'actions': {
        'success': true,
        'images': {
            'image_path',
            'image_path',
            'image_path'
        },
        'actions': {'eyes_close', 'look_up'}
    },
    'blinkId': {
        'fullName': '...',
        'age': '...',
        'address': '...',
        'documentNumber': '...',
        'dateOfExpiry': '...',
        'frontImage': 'image_path',
        'backImage': 'image_path',
        'faceImage': 'image_path'
    },
    'selfieLive': {
        'result': ' live',
        'liveTries': 1,
        'success': true
    } ,
    'selfieCropping': {
        'img': 'image_path',
        'vector': {23.42342, 3.2342, 5.322, ...},
        'success': true
    },
    'idCropping': {
        'img': 'image_path',
        'vector': {23.42342, 3.2342, 5.322, ...},
        'success': true
    },
    'matching':{
        'value': 0.531421528331689,
        'matched': true
    } 
}

不成功的身份验证结果

{
    'message': '.......',
    'reasonCode': 'MAX_ATTEMPTS, // one of  'MAX_ATTEMPTS', 'INTERNAL_ERROR'
}