face_camera

A Flutter camera plugin that detects face in real-time.

Preview

Installation

face_camera: ^<latest-version>

iOS

<key>NSCameraUsageDescription</key>
<string>your usage description here</string>
<key>NSMicrophoneUsageDescription</key>
<string>your usage description here</string>

Android

minSdkVersion 21

Usage

void main() async{
 WidgetsFlutterBinding.ensureInitialized(); //Add this
 await FaceCamera.initialize(); //Add this
 runApp(const MyApp());
}

 late FaceCameraController controller;
 @override
 void initState() {
 controller = FaceCameraController(
 autoCapture: true,
 defaultCameraLens: CameraLens.front,
 onCapture: (File? image) {
 
 },
 );
 super.initState();
}

 @override
 Widget build(BuildContext context) {
 return Scaffold(
 body: SmartFaceCamera(
 controller: controller,
 message: 'Center your face in the square',
 )
 );
 }

Customization

Fixed Frame Mode

FaceCameraController(
 autoCapture: true,
 captureDelay: 3,
 defaultCameraLens: CameraLens.front,
 showDebugLandmarks: false,
 onCapture: (File? image) {
 // Handle captured image
 },
)
SmartFaceCamera(
 controller: controller,
 indicatorShape: IndicatorShape.fixedFrame,
 messageBuilder: (context, face) {
 if (controller.value.countdown != null) {
 return _buildMessage('Hold still...');
 }
 final guidance = controller.getFacePositionGuidance();
 return _buildMessage(guidance ?? 'Ready');
 },
)
Widget _buildMessage(String message) => Padding(
 padding: EdgeInsets.symmetric(horizontal: 55, vertical: 15),
 child: Text(
 message,
 textAlign: TextAlign.center,
 style: TextStyle(fontSize: 14, fontWeight: FontWeight.w400),
 ),
);

messageBuilder: (context, face) {
 // Show countdown message
 if (controller.value.countdown != null) {
 return _buildMessage('Hold still... ${controller.value.countdown}');
 }
 // Get default guidance
 final guidance = controller.getFacePositionGuidance();
 // Customize messages
 String message;
 switch (guidance) {
 case 'Move closer':
 message = 'Come closer to the camera';
 break;
 case 'Move back':
 message = 'Move away from the camera';
 break;
 case 'Move left':
 message = 'Move to your left';
 break;
 case 'Move right':
 message = 'Move to your right';
 break;
 case 'Move up':
 message = 'Lift your phone higher';
 break;
 case 'Move down':
 message = 'Lower your phone';
 break;
 case 'Center your face':
 message = 'Almost there, center your face';
 break;
 case 'Place your face in the frame':
 message = 'Position your face in the frame';
 break;
 default:
 message = 'Perfect! Capturing...';
 }
 return _buildMessage(message);
}

messageBuilder: (context, face) {
 if (controller.value.countdown != null) {
 return _buildMessage(AppLocalizations.of(context).holdStill);
 }
 final guidance = controller.getFacePositionGuidance();
 final translations = {
 'Move closer': AppLocalizations.of(context).moveCloser,
 'Move back': AppLocalizations.of(context).moveBack,
 'Move left': AppLocalizations.of(context).moveLeft,
 'Move right': AppLocalizations.of(context).moveRight,
 // ... more translations
 };
 return _buildMessage(
 translations[guidance] ?? AppLocalizations.of(context).ready
 );
}

Capture Countdown

FaceCameraController(
 autoCapture: true,
 captureDelay: 3, // 3-second countdown (default)
 onCapture: (File? image) {
 // Handle captured image
 },
)

Contributions

Support the Library