金融级实人认证服务提供Flutter客户端SDK，帮助您在业务应用（App）中实现刷脸认证功能。本文结合示例代码介绍Flutter客户端的接入流程。
使用限制
不支持模拟器调试及使用，请您使用真机开发及功能测试。
仅支持iOS 9.0、Android 5.0及以上版本的移动智能设备（手机或Pad）接入。
依赖配置
下载Flutter SDK并解压。
说明当前 Flutter SDK 中使用的金融级实人认证SDK版本为2.3.39。
Flutter SDK中的接口介绍，请参见接口说明。
将解压后的Flutter SDK拷贝至业务工程。
编辑业务工程中的pubspec.yaml文件，并在dependencies字段下增加阿里云刷脸插件依赖。
aliyun_face_plugin: path: aliyun_face_plugin
Android环境配置
增加模块依赖
编辑业务工程下/android/build.gradle文件，在allprojects字段中增加flatDir配置。
flatDir {
dirs project(':aliyun_face_plugin').file('libs')
}
如果您使用了高版本的Flutter出现报错：Namespace not specified. Specify a namespace in the module's build file.
可以尝试在/android/build.gradle文件，在android字段中增加namespace = com.aliyun.face.aliyun_face_plugin。
配置Proguard混淆规则
如果在release场景下配置了Proguard代码混淆，则需要在业务工程的android/app/proguard-rules.pro文件中添加如下规则：
# 必须要依赖到应用混淆中
-keepclassmembers,allowobfuscation class * {
@com.alibaba.fastjson.annotation.JSONField <fields>;
}
-keep class net.security.device.api.** {*;}
-keep class face.security.device.api.** {*;}
-keep class com.alipay.deviceid.** { *; }
-keep class org.json.** { *;}
-keep class com.alibaba.fastjson.** {*;}
# SDK混淆配置
-keep class com.alipay.face.api.** {*;}
-keep class com.alipay.zoloz.toyger.**{*;}
-keep class com.dtf.face.api.** {*;}
-keep class com.dtf.face.ocr.verify.DTFOcrFacade { *; }
-keep class com.dtf.face.verify.** {*;}
-keep class com.dtf.face.network.model.** {*;}
-keep class com.dtf.face.network.APICallback {*;}
-keep class com.dtf.face.config.**{*;}
-keep class com.dtf.face.log.** {*;}
-keep class com.dtf.face.ui.overlay.** {*;}
-keep class com.dtf.face.ui.widget.ToygerWebView {*;}
-keep class com.dtf.face.utils.ClientConfigUtil{
boolean needUploadPreviewTrace*();
boolean needVideoExDegrade*();
boolean isCfgVideoExDevice*();
}
-keep class com.dtf.toyger.base.** {*;}
-keep class com.dtf.face.network.mpass.biz.model.** { *; }
-keep class com.dtf.face.utils.LogUtils { *; }
-keep class com.dtf.wish.api.** { *; }
-keep class com.dtf.wish.ui.** { *; }
-keep class com.dtf.wish.ui.WishFragment{*;}
-keep class com.dtf.voice.api.** { *; }
-keep class xnn.* { *; }
-keep class facadeverify.** { *; }
-keep class baseverify.** { *; }
-keep class faceverify.** { *; }
-keep class ocrverify.** { *; }
-keep class wishverify.** { *; }
# R8编译混淆配置
-keep class com.dtf.face.ui.toyger.FaceLoadingFragment{ *; }
-keep class com.dtf.face.ui.toyger.FaceShowFragment{*;}
-keep class com.dtf.face.ui.toyger.FaceShowElderlyFragment{*;}
-keepclassmembers class com.dtf.face.camera.ICameraCallback{
void onPreviewFrame*(*);
}
# NFC编译配置
-keep class com.dtf.face.nfc.verify.DTFNfcFacade { *; }
-keep class com.eidlink.**{*;}
-keep class net.sf.**{*;}
-keep class org.**{*;}
-keep class cn.**{*;}
-keep class com.froad.**{*;}
-keep class com.huawei.**{*;}
-keep class com.eidlink.**{*;}
-keep class org.ejbca.cvc.**{*;}
-keep class org.jmrtd.**{*;}
-keep public class com.netease.nis.sdkwrapper.Utils {public <methods>;}
-keep class net.sf.scuba.**{*;}
-keep class org.eid_bc.bouncycastle.jcajce.provider.symmetric.**{*;}
# 忽略警告
-dontwarn okio.**
-dontwarn org.apache.commons.codec.binary.**iOS环境配置
添加Camera权限
使用Xcode打开Runner工程（业务工程/ios/Runner.xcworkspace）。
按照下图指引，在Runner工程的Info.plist文件中增加Camera权限。
Value值需要您根据业务自定义。
添加framework
在Link Binary With Libraries配置项中添加SDK的framework和系统依赖库。framework位于解压后的Flutter SDK目录下，路径为aliyun_face_plugin/ios/Products/。
SDK中的framework：
AliyunFaceAuthFacade.framework
APBToygerFacade.framework
APPSecuritySDK.framework
BioAuthEngine.framework
faceguard.framework
DTFIdentityManager.framework
DTFUtility.framework
MultiFactorFacade.framework
OCRDetectSDKForTech.framework
ToygerNative.framework
ToygerService.framework
VerifyNativeAbility.framework系统依赖库：
CoreGraphics.framework
Accelerate.framework
SystemConfiguration.framework
AssetsLibrary.framework
CoreTelephony.framework
QuartzCore.framework
CoreFoundation.framework
CoreLocation.framework
ImageIO.framework
CoreMedia.framework
CoreMotion.framework
AVFoundation.framework
WebKit.framework
libresolv.tbd
libz.tbd
libc++.tbd
libc++.1.tbd
libc++abi.tbd
AudioToolbox.framework
CFNetwork.framework
MobileCoreServices.framework
libz.1.2.8.tbd
AdSupport.framework
ReplayKit.framework添加Bundle
按照下图指引，在Copy Bundle Resources配置项中添加以下Bundle。Bundle位于解压后的Flutter SDK目录下，路径为aliyun_face_plugin/ios/Products/。
ToygerService.bundle：位于ToygerService.framework中。
APBToygerFacade.bundle：位于APBToygerFacade.framework中。
APBToygerFacadeSuitable.bundle：位于APBToygerFacade.framework中。
OCRXMedia.bundle：位于OCRDetectSDKForTech.framework中。
BioAuthEngine.bundle：位于BioAuthEngine.framework中。
增加-ObjC链接标志
按照下图指引，在Other Linker Flags配置项中添加-ObjC标志。
接口说明
Flutter SDK包含初始化SDK（init）、获取MetaInfos（getMetaInfos）、自定义UI（setCustomUI）和开始认证（verify）四个接口。
class AliyunFacePlugin {
// SDK初始化接口
Future<void> init() {
return AliyunFacePluginPlatform.instance.init();
}
// 获取客户端的metainfos，用于服务器端接口获取认证id，即CertifyId
Future<String?> getMetaInfos() {
return AliyunFacePluginPlatform.instance.getMetaInfos();
}
// SDK认证接口
Future<String?> verify(Map<String, String> params) {
return AliyunFacePluginPlatform.instance.verify(params);
}
// SDK自定义UI
Future<String?> setCustomUI(String configuration) {
return AliyunFacePluginPlatform.instance.setCustomUI(configuration);
}
}初始化SDK
描述：主要用于人脸模型及人脸安全模块的初始化。需要在应用刚启动，用户确认App隐私协议之后，尽可能早的调用。
函数原型：
Future<void> init() { return AliyunFacePluginPlatform.instance.init(); }返回值：无。
获取MetaInfos
描述：该接口返回客户端的环境信息，客户端需要将这些信息发送至业务服务器端，业务服务器端将这些信息作为参数之一（MetaInfo）调用服务端初始化认证接口InitFaceVerify，从而获取CertifyId，用于后续认证环节。
函数原型：
Future<String?> getMetaInfos() { return AliyunFacePluginPlatform.instance.getMetaInfos(); }返回值：无。
自定义UI
描述：可自定义认证页面的UI颜色、icon图标等内容。
函数原型：
Future<String?> setCustomUI() { return AliyunFacePluginPlatform.instance.setCustomUI(configuration); }
开始认证
描述：用于发起实人认证请求。
函数原型：
Future<String?> verify(Map<String, String> params) { return AliyunFacePluginPlatform.instance.verify(params); }参数 params：JSON格式传入认证ID（CertifyId）和扩展参数Key-Value（详情见Android和iOS的extParams说明）：
{"certifyId":"认证id","扩展参数key":"扩展参数value"}重要每个CertifyId只能使用一次，否则会返回错误。错误信息如下：
iOS：2002,ZIMNetworkfail。
Android：1001,NET_RESPONSE_INVALID。
您可以在为扩展参数传值前判断运行环境是Android还是iOS，从而传入准确的extParams值（推荐），也可以将两个环境的extParams一起传入。
返回值：返回实人认证请求状态。格式为
code,reson，中间以逗号（,）分隔。code为错误码；reson为具体原因。说明iOS、Android平台的code及reson释义可能会有不同，以相应的文档说明为准。
示例代码
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutter/services.dart';
import 'package:aliyun_face_plugin/aliyun_face_plugin.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatefulWidget {
const MyApp({super.key});
@override
State<MyApp> createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
String _infos = 'Unknown';
final _aliyunFacePlugin = AliyunFacePlugin();
@override
void initState() {
super.initState();
// 在App启动的早期调用init接口。
_aliyunFacePlugin.init();
}
Future<void> getMetaInfos() async {
String metainfos;
try {
// 获取客户端metainfos，将信息发送到服务器端，调用服务器端相关接口获取认证ID，即CertifyId。
metainfos = await _aliyunFacePlugin.getMetaInfos() ?? 'Unknown metainfos';
} on PlatformException {
metainfos = 'Failed to get metainfos.';
}
setState(() {
_infos = "metainfos: " + metainfos;
});
}
Future<void> startVerify() async {
String verifyResult;
try {
// 调用认证接口，CertifyId需要调用服务器端接口获取。
// 每个CertifyId只能使用一次，否则会返回code: "2002(iOS), 1001(Android)"。
Map<String, String> params = {"certifyId":"认证id","扩展参数key":"扩展参数value"};
verifyResult = await _aliyunFacePlugin.verify(
params) ??
'-1,error';
} on PlatformException {
verifyResult = '-2,exception';
}
setState(() {
_infos = "verifyResult: " + verifyResult;
});
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('Aliyun face plugin demo')),
body: Center(
child: Column(children: <Widget>[
Text('$_infos\n'),
ElevatedButton(
onPressed: () async {
getMetaInfos();
},
child: Text("getMetaInfos")),
ElevatedButton(
onPressed: () async {
startVerify();
},
child: Text("startVerify")),
])),
),
);
}
}
完整代码示例，请点击Demo下载。