page_type	languages	products	name	urlFragment
sample	javascript	azure azure-cognitive-services	FaceAPI Enrollment Sample	faceapi-enrollment-sample

Build an enrollment app for Android with React Native

This guide will show you how to get started with the sample Face enrollment application. The app demonstrates best practices for obtaining meaningful consent to enroll users into a face recognition service and acquire high-accuracy face data. An integrated system could use an enrollment app like this to provide touchless access control, identity verification, attendance tracking, personalization kiosk, or identity verification, based on their face data.

When launched, the application shows users a detailed consent screen. If the user gives consent, the app prompts for a username and password and then captures a high-quality face image using the device's camera.

The sample enrollment app is written using JavaScript and the React Native framework. It can currently be deployed on Android devices; more deployment options are coming in the future.

Getting Started

Prerequisites

• An Azure subscription – Create one for free.
• Once you have your Azure subscription, create a Face resource in the Azure portal to get your key and endpoint. After it deploys, select Go to resource.
  • You'll need the key and endpoint from the resource you created to connect your application to Face API.
  • For local development and testing, you can paste the API key and endpoint into the configuration file. For final deployment, store the API key in a secure location and never in the code.

Important

These subscription keys are used to access your Cognitive Service API. Do not share your keys. Store them securely, for example, using Azure Key Vault. We also recommend regenerating these keys regularly. Only one key is necessary to make an API call. When regenerating the first key, you can use the second key for continued access to the service.

Installation

1. Clone the git repository for the sample enrollment app.
2. To set up your development environment, follow the React Native documentation . Select React Native CLI Quickstart as your development OS and select Android as the target OS. Complete the sections Installing dependencies and Android development environment.
3. Open the env.json file in your preferred text editor, such as Visual Studio Code, and add your endpoint and key. You can get your endpoint and key in the Azure portal under the Overview tab of your resource. This step is only for local testing purposes—don't check in your Face API key to your remote repository.
4. Run the app using either the Android Virtual Device emulator from Android Studio, or your own Android device. To test your app on a physical device, follow the relevant React Native documentation .

Quickstart

1. git clone https://github.com/Azure-Samples/cognitive-services-FaceAPIEnrollmentSample.git
2. cd cognitive-services-FaceAPIEnrollmentSample
3. cd referenceEnrollApp
4. npm install
5. start the metro bundler : npx react-native start
6. Either set up an Android Vitrual Device emulator on Android Studio, or plug in your Android device via USB. To check your device is recognized run: adb devices
7. Run npx react-native run-android. This will build and launch the app onto the emulator or device.
8. Fill out all relevant values in the env.json file.

Create an enrollment experience

Now that you have set up the sample enrollment app, you can tailor it to your own enrollment experience needs.

For example, you may want to add situation-specific information on your consent page:

The service provides image quality checks to help you make the choice of whether the image is of sufficient quality to enroll the customer or attempt face recognition. This app demonstrates how to access frames from the device's camera, select the highest-quality frames, and enroll the detected face into the Face API service.

Many face recognition issues are caused by low-quality reference images. Some factors that can degrade model performance are:

• Face size (faces that are distant from the camera)
• Face orientation (faces turned or tilted away from camera)
• Poor lighting conditions (either low light or backlighting) where the image may be poorly exposed or have too much noise
• Occlusion (partially hidden or obstructed faces) including accessories like hats or thick-rimmed glasses)
• Blur (such as by rapid face movement when the photograph was taken).

Notice the app also offers functionality for deleting the user's enrollment and the option to re-enroll.

To extend the app's functionality to cover the full enrollment experience, read the overview for additional features to implement and best practices.

Deploy the enrollment app

Android

First, make sure that your app is ready for production deployment: remove any keys or secrets from the app code and make sure you have followed the security best practices.

When you're ready to release your app for production, you'll generate a release-ready APK file, which is the package file format for Android apps. This APK file must be signed with a private key. With this release build, you can begin distributing the app to your devices directly.

Follow the Prepare for release documentation to learn how to generate a private key, sign your application, and generate a release APK.

Once you've created a signed APK, see the Publish your app documentation to learn more about how to release your app.

Resources

In this guide, you learned how to set up your development environment and get started with the sample enrollment app. If you're new to React Native, you can read their getting started docs to learn more background information. It also may be helpful to familiarize yourself with Face API. Read the other sections on enrollment app documentation before you begin development.