Flutter版本校验插件vcheck_flutter的使用

vcheck_flutter 是一个用于快速和安全地验证用户身份的服务插件。它支持通过 Flutter（适用于 iOS 和 Android）进行集成，为开发者提供了便捷的身份验证解决方案。

特性

• 文档有效性验证：支持国家和文件类型的识别，并检查伪造或干扰（如反光、覆盖物、第三方物体等）。
• 文档数据识别：自动解析上传的文件数据。
• 活体检测：确定正在验证的是真实的人。
• 人脸匹配：验证文件所有者与正在验证的用户是否一致。
• 易于集成到现有的 Flutter 应用中。

如何使用

1. 添加依赖

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  vcheck_flutter: ^1.4.3

然后运行 flutter pub get 来安装依赖。

2. 初始化 SDK 流程

import 'package:vcheck_flutter/vcheck_flutter.dart';

void startSDK({
  VerificationSchemeType verificationScheme = VerificationSchemeType.FULL_CHECK,
}) async {
  // 加载设计配置文件
  String designConfig;
  if (_isDefaultTheme == false) {
    designConfig = await DefaultAssetBundle.of(context)
        .loadString("assets/light_test_theme.json");
  } else {
    designConfig = await DefaultAssetBundle.of(context)
        .loadString("assets/default_dark_test_theme.json");
  }

  // 启动 VCheck SDK
  VCheckSDK.start(
    verificationToken: VERIFICATION_TOKEN, // 验证令牌
    verificationScheme: verificationScheme, // 验证方案类型
    languageCode: "en", // 语言代码
    environment: VCheckEnvironment.DEV, // 环境设置（开发环境）
    partnerEndCallback: partnerEndCallback(), // 验证完成回调
    onVerificationExpired: onVerificationExpired(), // 验证过期回调
    designConfig: designConfig, // 自定义主题配置
  );
}

3. 必需属性说明

4. 可选属性说明

完整示例代码

以下是完整的示例代码，展示了如何在 Flutter 中集成和使用 vcheck_flutter 插件。

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:vcheck_flutter/vcheck_flutter.dart';
import 'package:vcheck_flutter_example/result_widget.dart';

// 您应该从服务提供商处获取验证令牌
const String VERIFICATION_TOKEN = 'to-get-from-service';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  final navigatorKey = GlobalKey<NavigatorState>();

  bool _isDefaultTheme = true;

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('VCheck Flutter demo'),
        ),
        body: Center(
          child: Padding(
            padding: const EdgeInsets.all(25.0),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                const SizedBox(width: 0, height: 50),
                MaterialButton(
                  color: Colors.blue,
                  textColor: Colors.white,
                  onPressed: () {
                    startSDK(
                      verificationScheme: VerificationSchemeType.FULL_CHECK,
                    );
                  },
                  child: const Text("Full scheme"),
                ),
                const SizedBox(width: 0, height: 20),
                MaterialButton(
                  color: Colors.blue,
                  textColor: Colors.white,
                  onPressed: () {
                    startSDK(
                      verificationScheme: VerificationSchemeType.DOCUMENT_UPLOAD_ONLY,
                    );
                  },
                  child: const Text("Document upload"),
                ),
                const SizedBox(width: 0, height: 20),
                MaterialButton(
                  color: Colors.blue,
                  textColor: Colors.white,
                  onPressed: () {
                    startSDK(
                      verificationScheme: VerificationSchemeType.LIVENESS_CHALLENGE_ONLY,
                    );
                  },
                  child: const Text("Face check"),
                ),
                const SizedBox(width: 0, height: 30),
                Row(
                  crossAxisAlignment: CrossAxisAlignment.center,
                  children: [
                    const Text("Use default theme"),
                    const SizedBox(width: 12),
                    CupertinoSwitch(
                      activeColor: Colors.blue.shade100,
                      thumbColor: Colors.blue,
                      trackColor: Colors.black12,
                      value: _isDefaultTheme,
                      onChanged: (value) => setState(() {
                        _isDefaultTheme = !_isDefaultTheme;
                      }),
                    ),
                  ],
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }

  // 平台消息异步处理，初始化 SDK
  Future<void> startSDK({
    VerificationSchemeType verificationScheme = VerificationSchemeType.FULL_CHECK,
  }) async {
    String designConfig;
    if (_isDefaultTheme == false) {
      designConfig = await DefaultAssetBundle.of(context)
          .loadString("assets/light_test_theme.json");
    } else {
      designConfig = await DefaultAssetBundle.of(context)
          .loadString("assets/default_dark_test_theme.json");
    }

    VCheckSDK.start(
      verificationToken: VERIFICATION_TOKEN,
      verificationScheme: verificationScheme,
      languageCode: "en",
      environment: VCheckEnvironment.DEV,
      partnerEndCallback: partnerEndCallback(),
      onVerificationExpired: onVerificationExpired(),
      designConfig: designConfig,
    );
    if (!mounted) return;
  }

  // 验证完成后的回调
  Function partnerEndCallback() {
    return () {
      debugPrint("Triggered Dart callback for SDK finish");

      navigatorKey.currentState?.push<void>(
        MaterialPageRoute<void>(
          builder: (BuildContext context) => const ResultWidget(),
        ),
      );
    };
  }

  // 验证过期后的回调
  Function onVerificationExpired() {
    return () {
      debugPrint("Triggered callback for verification expiration case");
    };
  }
}