baidu_face_plugin 1.0.2

Flutter Android iOS

A Flutter plugin for baidu face recognization and liveness.

baidu_face_plugin #

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

使用方式 #

注册百度开发者账号 #

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

申请并配置license #

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

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 avatar

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

初始化和配置 #

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 )

<application
    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 进行调整。

官方集成文档 #

安卓-有动作活体版

0
likes
70
pub points
7%
popularity

A Flutter plugin for baidu face recognization and liveness.

Repository (GitHub)
View/report issues

Documentation

API reference

Uploader

qnzxbyz735@gmail.com

License

Apache 2.0 (LICENSE)

Dependencies

flutter

More

Packages that depend on baidu_face_plugin