Flutter人脸识别与数据采集插件flutter_bdface_collect的使用

Flutter人脸识别与数据采集插件flutter_bdface_collect的使用

简介

flutter_bdface_collect 是一个百度人脸离线采集插件，只支持安卓和iOS平台【armeabi-v7a、arm64-v8a】。

注意事项

• SDK 仅支持 armeabi-v7a 和 arm64-v8a 架构。如果需要 x86 架构，请选择旧版 SDK（请参考相关文档）。
• 使用前请自行检查隐私授权。

SDK 版本

准备工作

Android

在 Android 项目的 app/src/main/assets 目录下放入百度离线采集SDK的Android授权文件，文件名固定为 idl-license.face-android。SDK会校验 apk 签名，请使用申请授权相符的签名证书。

iOS

在 Info.plist 的 dict 标签内添加以下内容：

<key>NSCameraUsageDescription</key>
<string>使用相机</string>

在 iOS 项目的 Runner 目录下放入百度离线采集SDK的iOS授权文件，文件名固定为 idl-license.face-ios，并将文件加入资源。

使用方法

初始化 (Init)

// 导入必要的包
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_bdface_collect/flutter_bdface_collect.dart';
import 'dart:io';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '人脸识别测试',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initFaceCollect();
  }

  Future<void> initFaceCollect() async {
    late var licenseId;
    if (Platform.isAndroid) licenseId = "demo-face-android";
    else if (Platform.isIOS) licenseId = "demo-face-ios";
    
    print('开始初始化');
    String? err = await FlutterBdfaceCollect.instance.init(licenseId);
    print('初始化结果${err == null ? '成功' : '失败'}');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("人脸识别测试")),
      body: Center(child: Text("点击按钮进行人脸识别")),
      floatingActionButton: FloatingActionButton(
        onPressed: () {},
        child: Icon(Icons.face),
      ),
    );
  }
}

采集 (Collect)

Future<void> _faceCollect() async {
  // 初始化步骤同上
  late String licenseId;
  if (Platform.isAndroid) {
    licenseId = 'flutter_bdface_collect_example-face-android';
  } else if (Platform.isIOS) {
    licenseId = 'flutter_bdface_collect_example-face-ios';
  }
  
  var err = await FlutterBdfaceCollect.instance.init(licenseId);
  if (err != null) print('百度人脸采集初始化失败:$err');
  
  // 配置活体检测类型
  var livenessTypeList = LivenessType.all.sublist(3);
  var config = FaceConfig(livenessTypes: Set.from(livenessTypeList));
  
  // 开始采集
  CollectResult res = await FlutterBdfaceCollect.instance.collect(config);
  print("百度人脸采集结果：error:${res.error} imageSrcBase64 isEmpty:${res.imageSrcBase64.isEmpty}");
  
  // 显示采集到的图像
  Uint8List? imageBytes;
  if (!res.imageSrcBase64.isEmpty) {
    imageBytes = base64Decode(res.imageSrcBase64);
  }
  
  setState(() {
    // 更新UI显示采集到的图像
  });
}

释放 (UnInit)

FlutterBdfaceCollect.instance.unInit();

完整示例 Demo

import 'dart:convert';
import 'dart:io';
import 'dart:typed_data';

import 'package:flutter/material.dart';
import 'package:flutter_bdface_collect/flutter_bdface_collect.dart';
import 'package:flutter_bdface_collect/model.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '人脸识别测试',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Uint8List? imageBytes;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("人脸识别测试")),
      body: Center(
        child: imageBytes == null
            ? const Text('未开始初始化')
            : Image.memory(imageBytes!),
      ),
      floatingActionButton: FloatingActionButton(
        tooltip: 'Increment',
        onPressed: _faceCollect,
        child: const Icon(Icons.face),
      ),
    );
  }

  Future<void> _faceCollect() async {
    late String licenseId;
    if (Platform.isAndroid) {
      licenseId = 'flutter_bdface_collect_example-face-android';
    } else if (Platform.isIOS) {
      licenseId = 'flutter_bdface_collect_example-face-ios';
    }
    
    var err = await FlutterBdfaceCollect.instance.init(licenseId);
    if (err != null) print('百度人脸采集初始化失败:$err');
    
    var livenessTypeList = LivenessType.all.sublist(3);
    var config = FaceConfig(livenessTypes: Set.from(livenessTypeList));
    
    CollectResult res = await FlutterBdfaceCollect.instance.collect(config);
    print("百度人脸采集结果：error:${res.error} imageSrcBase64 isEmpty:${res.imageSrcBase64.isEmpty}");
    
    if (res.imageSrcBase64.isEmpty) return setState(() => imageBytes = null);
    
    setState(() => imageBytes = base64Decode(res.imageSrcBase64));
  }
}