Flutter身份验证插件berbix_flutter的使用

Flutter身份验证插件berbix_flutter的使用

Berbix Flutter插件是一个围绕Berbix原生移动SDK（适用于Android和iOS）的Dart包装器。它使Berbix的客户能够在Flutter环境中快速实现一流的实名验证。如果你对使用Berbix进行身份验证感兴趣且还不是Berbix的客户，可以访问berbix.com了解更多详情。

获取客户端令牌

为了开始集成，你需要生成一个短期的客户端令牌。Berbix Verify API需要在你的后端进行集成。请参阅创建交易文档。

添加依赖

首先，我们需要将berbix_flutter作为依赖项添加到项目中。你可以在项目目录中执行以下命令：

flutter pub add berbix_flutter

这将更新你的pubspec.yml文件，如下所示：

# 其他设置
# ...
dependencies:
  flutter:
    sdk: flutter
  berbix_flutter: ^0.0.2

在更新配置之后，我们可以通过运行以下命令来获取新的包：

flutter pub get

集成

一旦依赖项被获取，我们就可以开始使用新包了。首先，我们需要在要启动Berbix流程的.dart文件中导入该包：

import 'package:berbix_flutter/berbix_flutter.dart';

设置客户端令牌

像任何其他Berbix SDK一样，Flutter SDK需要一个客户端令牌才能代表用户执行交易。你可以查看我们的服务器端文档以了解如何生成客户端令牌。

一旦你有了有效的客户端令牌，可以像这样传递给SDK：

// 替换为有效的令牌！
BerbixFlutter.setClientToken("client_token_for_session"); 

完成交易

一旦设置了客户端令牌，你可以通过调用以下方法来执行交易：

BerbixFlutter.startFlow();

此时，SDK将处理导航，直到用户完成或取消验证流程。

处理错误/异常

在设置客户端令牌时，如果缺少客户端令牌，可能会遇到BerbixMissingClientTokenError错误。如果令牌存在但存在问题，你会看到BerbixInvalidClientTokenException异常。

try {
  var result = await BerbixFlutter.setClientToken("your-client-token-here");
} on BerbixMissingClientTokenError catch (error) {
  // 忘记添加客户端令牌
} catch (error) {
  // 其他地方出现问题
  FlutterError.presentError(error);
}

在展示流程时，你可能会遇到其他异常，可以像这样捕获它们：

try {
  var result = await BerbixFlutter.startFlow();
} catch (error) {
  // 在完成流程时出错
  FlutterError.presentError(error);
  // 错误区域在 error.code 中 ("user", "api", "camera", "state", "berbix")
  // 详细的错误消息在 error.details 中
}

虽然你不需要担心每个平台上的错误类型，但还是值得回顾一下我们iOS和Android SDK生成的错误类型，因为Flutter插件只会返回这些错误的包装版本。

完整示例Demo

下面是一个完整的示例Demo，展示了如何在Flutter应用中使用Berbix Flutter插件进行身份验证。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Berbix Flutter Demo'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              try {
                // 设置客户端令牌
                await BerbixFlutter.setClientToken("your-client-token-here");

                // 开始验证流程
                var result = await BerbixFlutter.startFlow();

                // 打印结果
                print(result);
              } on BerbixMissingClientTokenError catch (error) {
                // 忘记添加客户端令牌
                print('客户端令牌缺失');
              } catch (error) {
                // 其他地方出现问题
                print('发生错误: $error');
              }
            },
            child: Text('开始验证'),
          ),
        ),
      ),
    );
  }
}