Flutter身份验证插件new_raven_verification的使用

KYC_VERIFICATION

一个用于验证BVN/NIN的新Flutter包。

iOS要求

在ios/Runner/info.plist文件中更新以下内容：

<key>NSCameraUsageDescription</key>
<string>允许相机权限</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>允许访问相册以存储捕获的图像</string>

Android要求

在AndroidManifest.xml中添加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<!-- 添加此段代码以在Google Play商店安装时下载mlkit -->
<application ...>
    ...
    <meta-data
        android:name="com.google.mlkit.vision.DEPENDENCIES"
        android:value="face" >
</application>

使用方法

首先，确保已导入必要的依赖项：

import 'package:flutter/material.dart';
import 'package:new_raven_verification/new_raven_verification.dart'; // 假设插件名为new_raven_verification

接下来，使用以下代码启动身份验证插件：

void startVerification(BuildContext context) {
  KycConfig.startPlugin(
    context,
    KycConfig.getInstance(
      atlasUrl: "https://atlas.base_url.com", // Atlas服务器地址
      clientNumber: "client_bvn", // 客户端BVN（可选）
      baseColor: const Color(0xFF0B8376), // 自定义主色调
      metaData: "{meta data}", // 发送到服务器的元数据
      bearer: "PUBLIC_KEY", // Atlas上的公钥
      onErrorMessage: (String error) {
        // 错误回调
        print("Error: $error");
      },
      failiure: (dynamic data) {
        // 验证失败回调
        print("Verification failed with data: $data");
      },
      success: (dynamic data) {
        // 验证成功回调
        print("Verification successful with data: $data");
      },
    ),
  );
}

注意事项

• atlasUrl：Atlas服务器地址。
• clientBVN：客户端BVN（可选），如果未提供或为空，插件会自动收集BVN。
• baseColor：可以自定义插件的主题颜色以匹配应用的主色调。
• metaData：发送到服务器的元数据。
• bearerToken：在Atlas上注册以获取您的公钥。
• onErrorMessage：错误回调，所有错误都会通过此回调传递，并且插件依赖于应用的Toast功能来显示错误信息。
• success：验证成功的回调。
• failiure：验证失败的回调。

示例代码完整示例

以下是完整的示例代码，展示如何集成并使用该插件：

import 'package:flutter/material.dart';
import 'package:new_raven_verification/new_raven_verification.dart'; // 假设插件名为new_raven_verification

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text("BVN Verification Example")),
        body: Center(
          child: ElevatedButton(
            onPressed: () => startVerification(context),
            child: Text("Start Verification"),
          ),
        ),
      ),
    );
  }
}

void startVerification(BuildContext context) {
  KycConfig.startPlugin(
    context,
    KycConfig.getInstance(
      atlasUrl: "https://atlas.base_url.com",
      clientNumber: "client_bvn",
      baseColor: const Color(0xFF0B8376),
      metaData: "{meta data}",
      bearer: "PUBLIC_KEY",
      onErrorMessage: (String error) {
        print("Error: $error");
      },
      failiure: (dynamic data) {
        print("Verification failed with data: $data");
      },
      success: (dynamic data) {
        print("Verification successful with data: $data");
      },
    ),
  );
}