FaceMe

FaceMe® is a facial recognition software from Cyberlink. This app allows you to extract face attributes from FaceMe® SDK and create dynamic content based on face attributes via triggers.

Prerequisites

Contact support@dise.com or your Dise Key Partner Manager to have the FaceMe® add-on software added to your portal.

• FaceMe® software add-on in Dise CX Portal

• FaceMe® license from Cyberlink

• System Bridge

• Webcamera connected to the media player

Installing the app

1. In addition to the System Bridge installation guide you also need to run the command: 
   pip install opencv-python

2. Download the FaceMe Trigger template:

   FaceMe

   663.92 KB

3. Upload the zip as a template in the CMS

Using the app

The app has several parameters that can be configured. Use the custom editor to configure the app according to your needs. The required settings are located under Base configuration, and the two mandatory values are License key (obtained from CyberLink for FaceMe®) and Device index All other settings can be adjusted to suit your specific requirements.

The Trigger name you define under Triggers becomes active when all conditions in that trigger are true for atleast one detected face. You can add multiple trigger names with different condition sets, for example age18plus with age: 18-99, or happyFemales with gender: female and emotion: happy. If any configured scenario matches a face, the corresponding trigger name will be activated and the scenario shown. To configure Triggers, follow this guide.

When a trigger is activated, it remains active as long as at least one face matches the trigger conditions. Once no matching faces are detected, the timeout period begins. When the timeout expires, the trigger is deactivated.

Base configuration

• License key

  The FaceMe license key used to activate and authorize the SDK.

• Chipset

  Selects which processing backend the SDK should use for face analysis. Default value: CPU

• Model preset

  Chooses the FaceMe model preset that controls which recognition model configuration is used. Default value: VH11

• Min face ratio (%)

  Defines the minimum face size, as a percentage of the frame, required before a face is processed. Default value: 5

• Max detection threads

  Sets the maximum number of threads the SDK may use for face detection. Default value: 1

• Max extraction threads

  Sets the maximum number of threads the SDK may use for feature and attribute extraction. Default value: 1

• Max process rate (fps)

  Limits how many frames per second are allowed to continue into processing. Default value: 3

• Device index

  Selects which available camera to use based on its position in the detected camera list. To see all available cameras, check the display log. Default value: 0

• Capture width

  Sets the preferred capture width in pixels for the camera stream. Default value: 1280

• Capture height

  Sets the preferred capture height in pixels for the camera stream. Default value: 720

• Capture rate

  Sets the preferred capture frame rate in frames per second. Default value: 30

Triggers

1. Click on + Add

2. Set a Trigger name

3. Optional: Set a Timeout in seconds

4. Click on + Add under Conditions

5. Select a type of condition:

   Age: Set an age interval, both from and to fields are required, i.e 18-99
   Gender: Male or female
   Emotion: Happy, surprised, sad, angry or neutral

6. Optional: Repeat step #5 for more triggers