Flutter身份识别插件smile_id的使用

Smile ID 提供了非洲地区实时数字KYC、身份验证、用户注册和用户认证的最佳解决方案。以下是如何在Flutter项目中集成和使用 smile_id 插件的详细步骤。

1. 环境要求

• Flutter 3.0.0+
• Dart 3.0.5+
• 从 Smile ID Portal 获取的 smile_config.json 文件
• 参考 Android特定要求
• 参考 iOS特定要求

2. 添加依赖

在你的 pubspec.yaml 文件中添加最新版本的 smile_id 依赖：

dependencies:
  smile_id: <latest-version>

3. 配置 smile_config.json

Android

将 smile_config.json 文件放置在应用的 assets 目录下，路径为 src/main/assets。如果该目录不存在，请创建它。

iOS

将 smile_config.json 文件拖入项目的文件检查器，并确保将其添加到应用程序的目标中。可以通过检查构建阶段选项卡中的“Copy Bundle Resources”确认这一点。

4. 初始化 SDK

在 main.dart 中初始化 Smile ID SDK：

import 'package:smile_id/smile_id.dart';

void main() {
  SmileID.initialize(useSandbox: false);
  runApp(const MyApp());
}

示例 Demo

以下是一个完整的示例代码，展示了如何使用 smile_id 进行身份验证和文档验证等功能：

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:smile_id/smile_id_document_capture_view.dart';
import 'package:smile_id/smile_id_smart_selfie_capture_view.dart';
import 'package:smile_id/smile_id.dart';
import 'package:smile_id/smile_id_biometric_kyc.dart';
import 'package:smile_id/smile_id_document_verification.dart';
import 'package:smile_id/smile_id_enhanced_document_verification.dart';
import 'package:smile_id/smile_id_smart_selfie_authentication.dart';
import 'package:smile_id/smile_id_smart_selfie_authentication_enhanced.dart';
import 'package:smile_id/smile_id_smart_selfie_enrollment.dart';
import 'package:smile_id/smile_id_smart_selfie_enrollment_enhanced.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    if (!mounted) return;
    SmileID.initialize(useSandbox: false);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: "Smile ID",
      home: MainContent(),
    );
  }
}

class MyScaffold extends StatelessWidget {
  final Widget body;

  const MyScaffold({super.key, required this.body});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        leading: const BackButton(),
        title: const Text("Smile ID"),
      ),
      body: body,
    );
  }
}

class MainContent extends StatelessWidget {
  const MainContent({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MyScaffold(
      body: Center(
        child: Column(
          children: [
            enhancedKycAsyncButton(),
            documentVerificationButton(context),
            smartSelfieEnrollmentButton(context),
            // Add other buttons as needed
          ],
        ),
      ),
    );
  }

  Widget enhancedKycAsyncButton() {
    return ElevatedButton(
      child: const Text("Enhanced KYC (Async)"),
      onPressed: () {
        var userId = "<your user's user ID>";
        SmileID.api
            .authenticate(FlutterAuthenticationRequest(
              jobType: FlutterJobType.enhancedKyc,
              userId: userId,
            ))
            .then((authResponse) {
              SmileID.api.doEnhancedKycAsync(FlutterEnhancedKycRequest(
                country: "GH",
                idType: "DRIVERS_LICENSE",
                idNumber: "B0000000",
                callbackUrl: "https://somedummyurl.com/demo",
                partnerParams: FlutterPartnerParams(
                  jobType: FlutterJobType.enhancedKyc,
                  jobId: userId,
                  userId: userId,
                ),
                timestamp: authResponse!.timestamp,
                signature: authResponse.signature,
              ));
            }, onError: (error) {
              print("error: $error");
            });
      },
    );
  }

  Widget documentVerificationButton(BuildContext context) {
    return ElevatedButton(
      child: const Text("Document Verification"),
      onPressed: () {
        Navigator.of(context).push(
          MaterialPageRoute<void>(
            builder: (BuildContext context) => MyScaffold(
              body: SmileIDDocumentVerification(
                countryCode: "GH",
                documentType: "DRIVERS_LICENSE",
                onSuccess: (String? result) {
                  Map<String, dynamic> jsonResult = json.decode(result ?? '{}');
                  String formattedResult = jsonEncode(jsonResult);
                  final snackBar = SnackBar(content: Text("Success: $formattedResult"));
                  ScaffoldMessenger.of(context).showSnackBar(snackBar);
                  Navigator.of(context).pop();
                },
                onError: (String errorMessage) {
                  final snackBar = SnackBar(content: Text("Error: $errorMessage"));
                  ScaffoldMessenger.of(context).showSnackBar(snackBar);
                  Navigator.of(context).pop();
                },
              ),
            ),
          ),
        );
      },
    );
  }

  Widget smartSelfieEnrollmentButton(BuildContext context) {
    return ElevatedButton(
      child: const Text("SmartSelfie Enrollment"),
      onPressed: () {
        Navigator.of(context).push(
          MaterialPageRoute<void>(
            builder: (BuildContext context) => MyScaffold(
              body: SmileIDSmartSelfieEnrollment(
                onSuccess: (String? result) {
                  Map<String, dynamic> jsonResult = json.decode(result ?? '{}');
                  String formattedResult = jsonEncode(jsonResult);
                  final snackBar = SnackBar(content: Text("Success: $formattedResult"));
                  ScaffoldMessenger.of(context).showSnackBar(snackBar);
                  Navigator.of(context).pop();
                },
                onError: (String errorMessage) {
                  final snackBar = SnackBar(content: Text("Error: $errorMessage"));
                  ScaffoldMessenger.of(context).showSnackBar(snackBar);
                  Navigator.of(context).pop();
                },
              ),
            ),
          ),
        );
      },
    );
  }
}