Skip to content

Licensing#

Mobile platforms#

FaceEngine supports per-features node-locked licensing for every supported platform. This means that by activating and deactivating the licensed features a final customer version of FaceEngine might be customized. For that reason, not all algorithms and modules described in this book might be available to you. Each SDK instance should be activated on every device. License, which was activated for one device could not be used on some other device. Interface for License objects ILicense (see file ILicense.h) gives you possibility to:

  • check if license is already activated;
  • save license for next usage to some file;
  • load license from file;
  • check if some feature of FaceEngine is available for this license;
  • check the expiration date for each feature in this license.

Typical usage scenario:

  • Create a FaceEngineType object (see file FaceEngine.h);
  • Get license pointer through fsdk::FaceEngineType::getLicense.
  • Make activation for that license object through fsdk::activateLicense. This method requires full or relative path to the license.conf file.

NOTE: Descriptor license feature allows creating no more than 1000 descriptors on mobile platforms.

NOTE: If the feature is not available for the current license or the feature has expired, an attempt to use the corresponding functionality will result in an error.

License features#

To work with license features in code the LicenseFeature enum should be used (see file ILicense.h). Some features are not available for some platforms.

Full list of features and according list of estimators available on mobile platforms:

  • Detection - allows to create IDetector instance to find person face on a frame;
  • BestShot - allows to create IAGSEstimator, IBestShotQualityEstimator, IHeadPoseEstimator instance;
  • FaceFeatures - allows to create IEyeEstimator instance;
  • Descriptor - allows to create IDescriptor, IDescriptorBatch, IDescriptorExtractor, IDescriptorMatcher instances to extract face features of a concrete person and work with them;
  • Liveness - allows to create IBestShotMobile instance to get a bestshot from video.
  • TrackEngine - allows to create ITrackEngine instance to track person on video.

If the license for the selected feature is invalid, the factory instantiation method will return nullptr. For example, method: IFaceEngine::createAGSEstimator will return nullptr in case if LicenseFeature::BestShot in not available.

NOTE: Other features such as Attributes, Emotions, Liveness, DescriptorIndex, LivenessEngine, HumanDetection are not availabls on mobile platforms.

Back to top