baidu_face_plugin

百度人脸识别和活体检测 Flutter 插件(目前版本仅支持 Android)

使用方式

注册百度开发者账号

前往 百度开发者账号 进行注册。

申请并配置license

1 . 登录 控制台，前往 全局->人工智能->人脸识别->人脸识别 - 离线采集SDK管理

2 . 新建授权，填入必须的信息(Android 签名方式自行 google，新建授权需要配置签名 MD5)，将结果配置在实际项目，参考 /example/android/app/build.gradle

signingConfigs {

def password = "111111"

def alias = "nutella"

def filePath = "/Users/yuanchongyu/nutella.jks" // 签名文件路径

debug {

keyAlias alias

keyPassword password

storeFile file(filePath)

storePassword(password)

}

release {

keyAlias alias

keyPassword password

storeFile file(filePath)

storePassword(password)

}

}

3 . 下载license放在实际项目中，参考 /example/android/app/src/main/assets/idl-license.face-android

步骤 2 和 3 中的配置可以在新建完授权后，可下载示例项目进行参考

初始化和配置

1 . 在实际项目中增加入口 application class(参考 com.example.baidu_face_plugin.baidu_face_plugin_example.MainApplication)，在"初始化SDK"的地方配置 License-ID 和 License-File-Name

// 初始化SDK

FaceSDKManager.getInstance().initialize(this, "baidu-face-plugin-face-android", "idl-license.face-android");

2 . 修改实际项目 AndroidManifest.xml 的入口 application class(参考 example - AndroidManifest.xml )

tools:replace="android:label"

android:name="com.example.baidu_face_plugin.baidu_face_plugin_example.MainApplication"

...

如何调用

1 . pubspec.yaml 中加入依赖

dependencies:

baidu_face_plugin: ^1.0.0

2 . import

import 'package:baidu_face_plugin/baidu_face_plugin.dart';

3 . call

LivenessResult result = await new BaiduFacePlugin().liveness();

DetectResult result = await new BaiduFacePlugin().detect();

result 包含两个属性(sucess和image)

success 属性表示是否完成并成功。如果 success == 'true'，则 image 返回最佳人脸照片(base64格式)

一些说明

关于入口 application class

入口 application class(参考 com.example.baidu_face_plugin.baidu_face_plugin_example.MainApplication)的作用是初始化和配置插件功能(活体需要哪些动作，是否随机出现；识别的光线、模糊、角度等质量要求；是否开启语音提示等)，视实际情况调整。如果你的项目中已经有入口 application class，可以合并。

关于UI样式调整

颜色的调整可以参考并重写 plugin module res/values 中的 colors.xml，放入实际项目的 res/values。

完全定制可以参考并重写 plugin module res/layout 中的 activity_face_detect_v3100.xml 和 activity_face_liveness_v3100.xml 两个文件，放入实际项目的 res/layout。

关于人脸识别和活体检测的结果照片

人脸识别和活体检测 成功后将返回base64格式最佳人脸照片(人脸识别就一张照片，活体检测返回的是多个动作中最佳的一张)，调试的时候需要打印完整日志(debug模式或自行分段)才能获取完整字符串。

关于多语言支持

支持多语言配置(语音和提示文字)，加入资源文件(src/main/res)后可在入口 application class 中配置(见 FaceSDKResSettings.initResMaps(soundMap, tipsMap);)。

关于依赖关系

官方示例项目中的依赖关系为 app->faceplatform-ui->faceplatform，集成时发现部分配置需要修改 faceplatform-ui 实现，所以将 faceplatform-ui 的源码拷贝在到了 plugin module 进行调整。

官方集成文档