Flutter身份验证插件flutter_idensic_mobile_sdk_plugin的使用

简介

flutter_idensic_mobile_sdk_plugin 是 Sumsub Mobile SDK 的 Flutter 插件。它提供了在 Flutter 应用中集成身份验证功能的能力。您可以通过访问 Sumsub Mobile SDK 和 Flutter Plugin 获取更多信息。

示例代码

以下是一个完整的示例，展示了如何使用 flutter_idensic_mobile_sdk_plugin 来启动身份验证流程。

主文件 (main.dart)

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_idensic_mobile_sdk_plugin/flutter_idensic_mobile_sdk_plugin.dart';
import 'dart:developer' as D;

SNSMobileSDK? snsMobileSDK;

void launchSDK() async {
  // 从您的后端获取用于验证申请人的访问令牌。
  // 访问令牌必须包含 `levelName` 和 `userId`，
  // 其中 `levelName` 是您在仪表板中配置的级别名称。
  final String accessToken = "your access token";

  // 访问令牌有有限的生命周期，当它过期时，您必须提供一个新的令牌。
  // 因此，请准备好从您的后端获取新的访问令牌。
  final onTokenExpiration = () async {
    D.log('_onTokenExpiration');
    // 调用您的后端以获取新的访问令牌（这只是示例）
    return Future<String>.delayed(Duration(seconds: 2), () => accessToken);
  };

  final builder = SNSMobileSDK.init(accessToken, onTokenExpiration);

  setupOptionalHandlers(builder);
  setupTheme(builder);

  snsMobileSDK = builder
    .withLocale(Locale("en")) // 设置语言环境
    .withDebug(false) // 设置调试模式
    .build();

  final result = await snsMobileSDK!.launch();

  D.log("Completed with result: $result");
}

void setupOptionalHandlers(SNSMobileSDKBuilder builder) {
  if (useApplicantConf) {
    builder.withApplicantConf({
      "email": "test@test.com",
      "phone": "123456789"
    });
  }

  if (usePreferredDocumentDefinitions) {
    builder.withPreferredDocumentDefinitions({
      "IDENTITY": {
        "idDocType": "PASSPORT",
        "country": "USA"
      },
      "IDENTITY2": {
          "idDocType": "DRIVERS",
          "country": "FRA"
      }
    });
  }

  if (useDisableAnalytics) {
    builder.withAnalyticsEnabled(false);
  }

  if (useCustomStrings) {
    builder.withStrings({
      "sns_general_poweredBy": "Custom watermark"
    });
  }

  if (useDisableAutoCloseOnApprove) {
    builder.withAutoCloseOnApprove(0);
  }

  final SNSStatusChangedHandler onStatusChanged = (SNSMobileSDKStatus newStatus, SNSMobileSDKStatus prevStatus) {
    D.log('onStatusChanged: $prevStatus -> $newStatus');

    // 仅为了展示 dismiss() 方法的工作原理
    if (useDismissTimer && prevStatus == SNSMobileSDKStatus.Ready) {
      Timer(Duration(seconds: 10), () {
        snsMobileSDK?.dismiss();
      });
    }
  };

  final SNSEventHandler onEvent = (SNSMobileSDKEvent event) {
    D.log("onEvent: $event");
  };

  final SNSActionResultHandler onActionResult = (SNSMobileSDKActionResult result) {
    D.log("onActionResult: $result");

    // 返回一个 `Future`，该 `Future` 应完成为 `SNSActionResultHandlerReaction` 类型的值
    // 您可以传递 `.Cancel` 强制用户界面关闭，或传递 `.Continue` 继续正常流程
    return Future.value(SNSActionResultHandlerReaction.Continue);
  };

  builder.withHandlers(
    onStatusChanged: onStatusChanged,
    onActionResult: onActionResult,
    onEvent: onEvent
  );

  void onLog(SNSLogLevel level, String message) {
    D.log('onLog: \'$level\' - $message');
  }

  builder.withLogHandler(onLog);
}

void setupTheme(SNSMobileSDKBuilder builder) {
  if (!useCustomTheme) {
    return;
  }

  builder.withTheme({
    // 自定义主题设置
    // 详细配置请参考完整代码示例
  });
}

// ------------------------------------------------------

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

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

var useDismissTimer = false;
var useApplicantConf = false;
var usePreferredDocumentDefinitions = false;
var useDisableAnalytics = false;
var useCustomStrings = false;
var useCustomTheme = false;
var useDisableAutoCloseOnApprove = false;

class _MyAppState extends State<MyApp> {

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
        home: Scaffold(
      appBar: AppBar(
        title: const Text('IdensicMobileSDK Plugin'),
      ),
      body: Container(
        alignment: Alignment.center,
        child: IntrinsicWidth(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: [
              Row(
                mainAxisSize: MainAxisSize.min,
                mainAxisAlignment: MainAxisAlignment.center,
                crossAxisAlignment: CrossAxisAlignment.center,
                children: [
                  ElevatedButton(
                    onPressed: () => launchSDK(),
                    child: Text("Launch Sumsub SDK"),
                  ),
                ]
              ),
              SizedBox(height: 16),
              // 其他UI组件和逻辑...
            ],
          ),
        ),
      ),
    ));
  }
}