Getting started

In this guide, you will learn how to install Face SDK on your PC and run the demo application.

Follow the instructions to get started with Face SDK:

Windows

1. Download the installer to install 3DiVi Face SDK.

2. Run the installer and follow the installation wizard.

3. In the "Component Selection" section, select the target platform to run Face SDK on (e.g. windows_x86_64) and click "Next" (More about component selection).

   

   Component Selection

note

Some components (e.g. 'linux_x86_64') create links during installation, so they cannot be installed on Windows.

4. Wait until all the necessary files are downloaded and installed on your device and complete the installation.

5. All the necessary files and folders should be created in the installation directory.

Warning

If you selected more than one target platform in step 3, you must switch to one of them using the switcher utility (more).

To install additional packages, use the maintenancetool utility (more).

6. Copy the 3divi_face_sdk.lic license file to the license folder.

   How do I get the 3divi_face_sdk.lic file?

   You can get a 3DiVi Face SDK Trial license for free, license file will be sent to your email.

   Trial license lets you use all features of 3DiVi Face SDK with the following limitations:

   • 14-day time limit
   • Running Face SDK at most one device simultaneously
   • Processing at most one video stream

   To remove trial limitations contact us at face@3divi.com.

6. Copy the 3divi_face_sdk.lic license file to the license folder.

How do I get the 3divi_face_sdk.lic file?

You will need a license to work with Face SDK. You can get a Face SDK trial license for free, the trial license file will be sent to your email.

The Face SDK trial license allows you to use all the features of the Face SDK, but has a number of limitations:

• Valid for 14 days.
• Allows you to use Face SDK on no more than one device at a time.
• Allows you to process no more than one video stream.

To remove the limitations of the trial version, write to us at face@3divi.com.

Linux

1. Download the installer to install 3DiVi Face SDK.

2. Run the command

chmod +x 3DiVi_FaceSDK_Installer_Linux

3. Run the installer and follow the prompts of the installation wizard.

4. In the "Component Selection" section, select the target platform to run Face SDK (for example linux_x86_64) and click "Next" (More about component selection).

   

   Select components

5. Wait until all the necessary files are downloaded and installed on your device and complete the installation.

6. All the necessary files and folders should be created in the installation directory.

Warning

If you selected more than one target platform in step 4, you need to switch to one of them using the switcher utility (more).

To install additional packages, use the maintenancetool utility (more).

7. Copy the 3divi_face_sdk.lic license file to the license folder.

How do I get the 3divi_face_sdk.lic file?

You will need a license to work with Face SDK. You can get a Face SDK trial license for free, the trial license file will be sent to your email.

The Face SDK trial license allows you to use all the features of the Face SDK, but has a number of limitations:

• Valid for 14 days.
• Allows you to use Face SDK on no more than one device at a time.
• Allows you to process no more than one video stream.

To remove the trial version restrictions, write to us at face@3divi.com.

MacOS

1. Download and unzip the archives for your target platform with models

2. All necessary files and folders should be created in the installation directory.

3. Copy the license file 3divi_face_sdk.lic to the license folder.

How to get the 3divi_face_sdk.lic file?

You will need a license to work with the Face SDK. You can get a trial license for Face SDK for free, the trial license file will be sent to your email.

The trial license for Face SDK allows you to use all the features of Face SDK, but has a number of limitations:

• Valid for 14 days.
• Allows you to use Face SDK simultaneously on no more than one device.
• Allows you to process no more than one video stream.

To remove the limitations of the trial version, write to us at face@3divi.com.

Run the demo application:

Windows/Linux

Connect the camera to your device, go to the bin folder and run the demo application. The camera image and detected faces should be displayed in the application window (Details).

Android

Copy the apk/demo.apk file to your Android device, install and run the app. The camera image and detected faces should be displayed on the screen (More).

iOS

Follow the Video Recognition Demo on iOS tutorial to run it.

Use our open source samples and tutorials to get started developing with the Face SDK.

If you encounter technical issues, please see Troubleshooting or contact technical support at support-facesdk@3divi.com.