face_recognition_flutter #

Offline face recognition and liveness detection Flutter plugin for Android and iOS. Built for FaceAISDK, it supports face enrollment, 1:1 face verification, liveness detection, and local face feature management.

[FaceAISDK Flutter demo]

Features #

• Offline face enrollment from SDK camera or Base64 image.
• 1:1 face verification with action, color, and silent liveness detection.
• Liveness-only detection for real-person checks.
• Local face feature query, insert, delete, and face image export.
• Built-in native UI plus direct Flutter API calls.

Platform Support #

Installation #

flutter pub add face_recognition_flutter

Android #

Add camera permission:

<uses-permission android:name="android.permission.CAMERA" />

Make sure minSdkVersion is at least 21.

iOS #

Add camera usage text to Info.plist:

<key>NSCameraUsageDescription</key>
<string>FaceAISDK needs camera access for face enrollment and liveness verification.</string>

Make sure the iOS deployment target is at least 15.5.

Quick Start #

import 'package:face_recognition_flutter/face_recognition_flutter.dart';

final result = await FaceRecognitionFlutter.faceVerify(
  faceId: 'user_001',
  threshold: 0.84,
  livenessType: 1,
  motionLivenessTypes: '1,2,3,4,5',
);

if (result.isSuccess) {
  print('Verified: ${result.similarity}');
}

Common APIs #

// Enroll by SDK camera.
await FaceRecognitionFlutter.addFaceBySDKCamera(faceId: 'user_001');

// Enroll by Base64 image.
await FaceRecognitionFlutter.addFaceBySDKImage(
  faceId: 'user_001',
  imageBase64: 'data:image/jpeg;base64,...',
);

// Liveness only.
await FaceRecognitionFlutter.livenessVerify(livenessType: 2);

// Face feature management.
await FaceRecognitionFlutter.getFaceFeature('user_001');
await FaceRecognitionFlutter.insertFaceFeature(faceId: 'user_001', feature: '...');
await FaceRecognitionFlutter.deleteFaceFeature('user_001');

Run the Example #

This is a Flutter plugin. Run the demo from the example app:

cd example
flutter run

If you run from the plugin root, specify the target:

flutter run -t example/lib/main.dart

Result Codes #

Troubleshooting #

• Target file "lib/main.dart" not found: run cd example && flutter run.
• iOS cannot find Swift demo views: run cd example/ios && pod install.
• Android Studio shows no devices while CLI works: restart adb with adb kill-server && adb start-server, then restart Android Studio.
• iOS simulator arm64 warnings may come from transitive MLKit/TensorFlowLite dependencies; use a real iOS device when needed.

Related SDKs #

• FaceAISDK iOS
• FaceAISDK Android
• FaceAISDK Flutter
• FaceAISDK React Native

face_recognition_flutter 中文说明 #

适用于 Android 和 iOS 的 FaceAISDK 离线人脸识别 Flutter 插件，支持人脸录入、1:1 人脸核验、活体检测和本地人脸特征管理。

功能 #

• 通过 SDK 相机或 Base64 图片录入人脸。
• 支持动作、炫彩、静默活体检测。
• 支持 1:1 人脸识别 + 活体检测。
• 支持查询、同步、删除本地人脸特征值。
• 支持原生内置 UI 和 Flutter API 直接调用。

平台支持 #

安装 #

flutter pub add face_recognition_flutter

Android 添加相机权限：

<uses-permission android:name="android.permission.CAMERA" />

iOS 在 Info.plist 添加：

<key>NSCameraUsageDescription</key>
<string>FaceAISDK needs camera access for face enrollment and liveness verification.</string>

快速使用 #

import 'package:face_recognition_flutter/face_recognition_flutter.dart';

final result = await FaceRecognitionFlutter.faceVerify(
  faceId: 'user_001',
  threshold: 0.84,
  livenessType: 1,
  motionLivenessTypes: '1,2,3,4,5',
);

if (result.isSuccess) {
  print('核验成功: ${result.similarity}');
}

运行示例 #

cd example
flutter run

如果在插件根目录运行：

flutter run -t example/lib/main.dart

结果状态码 #

常见问题 #

• Target file "lib/main.dart" not found：请进入 example 目录运行。
• iOS 找不到 Swift 示例页面：执行 cd example/ios && pod install。
• Android Studio 看不到设备：重启 adb 和 Android Studio。
• iOS 模拟器依赖架构警告：建议使用真机验证。