Flutter身份验证插件onfido_sdk的使用

Onfido SDK 提供了用户身份验证的功能，支持多种语言和平台，并且可以高度定制化。以下是如何在Flutter项目中集成和使用Onfido SDK的详细步骤。

添加依赖

首先，确保你的Flutter项目满足以下要求：

• Dart 3.1.0或更高版本
• Flutter 1.20或更高版本
• iOS 13+
• Android API level 21+

然后，在项目的根目录下运行以下命令来添加onfido_sdk包：

flutter pub add onfido_sdk

配置iOS

修改ios/Podfile文件以支持iOS 13：

platform :ios, '13.0'

确保在ios/Runner/Info.plist文件中添加以下权限：

<key>NSCameraUsageDescription</key>
<string>Required for document and facial capture</string>
<key>NSMicrophoneUsageDescription</key>
<string>Required for video capture</string>

初始化SDK

获取SDK Token

在初始化SDK之前，你需要通过Onfido API获取一个有效的SDK Token。你可以参考官方文档来了解如何生成SDK Token。

构建配置对象

下面是一个简单的示例，展示了如何构建并初始化Onfido SDK客户端：

import 'package:onfido_sdk/onfido_sdk.dart';

final Onfido onfido = Onfido(
  sdkToken: "<YOUR_SDK_TOKEN>",
  iosLocalizationFileName: "onfido_ios_localisation", // 可选
  onfidoTheme: OnfidoTheme.AUTOMATIC, // 可选
  nfcOption: NFCOptions.Disabled // 可选
);

启动流程

接下来，你可以通过调用startWorkflow方法启动身份验证流程，并传入一个workflowRunId：

await onfido.startWorkflow('workflowRunId');
// 监听响应

如果你不使用Onfido Studio，而是手动定义验证步骤，可以使用start方法：

try {
  final response = await onfido.start(
    flowSteps: FlowSteps(
      welcome: true,
      documentCapture: DocumentCapture(),
      faceCapture: FaceCapture.photo(withIntroScreen: true),
    ),
  );
  // 处理成功响应
} catch (error) {
  // 处理错误
}

完整的示例代码

下面是一个完整的示例，展示了如何在Flutter应用中集成Onfido SDK：

import 'package:flutter/material.dart';
import 'package:onfido_sdk/onfido_sdk.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Onfido Example',
      home: OnfidoPage(),
    );
  }
}

class OnfidoPage extends StatefulWidget {
  [@override](/user/override)
  _OnfidoPageState createState() => _OnfidoPageState();
}

class _OnfidoPageState extends State<OnfidoPage> {
  final Onfido _onfido = Onfido(
    sdkToken: "<YOUR_SDK_TOKEN>",
    onfidoTheme: OnfidoTheme.AUTOMATIC,
  );

  Future<void> _startOnfido() async {
    try {
      final response = await _onfido.startWorkflow('workflowRunId');
      print("Success: $response");
    } catch (e) {
      print("Error: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Onfido Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _startOnfido,
          child: Text('Start Onfido Verification'),
        ),
      ),
    );
  }
}