Yoti.FCM 1.0.0

Yoti Face Capture

Face capture user control handles the camera and validates the video stream frame by frame until it finds a valid face.

Dependencies

The package uses C++ libraries so the machines that run the face capture will need to install the Microsoft Visual C++ Redistributable packages.

Usage

1. Add the package dependency in your project.

2. Add the reference xmlns:yotiFCM="clr-namespace:Yoti.FCM;assembly=Yoti.FCM" in the view that will integrate the user control.

3. Render the user control:

   <yotiFCM:FaceCapture FaceDetected="<FaceCapture_FaceDetectedHandler>" />
   

It does not send the image to the Yoti AI service. The FaceDetected event will provide the base64 encoded image ready to be processed by the service. Use the .NET Yoti SDK or any other Yoti SDK (if the image is propagated to a back-end) to send the image and run a prediction.

This is the properties list for the FaceCapture:

Note: FaceCapture implements the interface IFaceCapture:

/// <summary>
/// Represents an entity that is able to detect a face from a stream like a webcam.
/// </summary>
public interface IFaceCapture
{
    /// <summary>
    /// Event that the face capture will trigger each time it detects a face.
    /// </summary>
    event EventHandler<FacesDetectedEventArgs> FaceDetected;

    /// <summary>
    /// Event to handle all inner exceptions from the face capture.
    /// </summary>
    event EventHandler<ExceptionEventArgs> OnError;

    /// <summary>
    /// Event to handle when the camera is ready to start the streaming and capture a face.
    /// </summary>
    event EventHandler ReadyToCapture;

    /// <summary>
    /// Starts the webcam stream and the face detection.
    /// </summary>
    void Play();

    /// <summary>
    /// Stops the webcam stream and the face detection.
    /// </summary>
    void Stop();
}

The package also provides the DefaultConfig class that implements all the configuration fields for the face capture user control.

Localisation

Set the FCM localisation by running the following code:

CultureInfo cultureInfo = new CultureInfo(SelectedLanguage);
Thread.CurrentThread.CurrentCulture = cultureInfo;
Thread.CurrentThread.CurrentUICulture = cultureInfo;
Application.Current.MainWindow.Language = XmlLanguage.GetLanguage(CultureInfo.CurrentCulture.IetfLanguageTag);

Where SelectedLanguage can be chosen from the following list:

• ar-XM
• bg-BG
• cs-CZ
• da-DK
• de-DE
• el-GR
• en
• es-419
• es-ES
• et-ET
• fa-IR
• fi-FI
• fr-FR
• he-IL
• hi-IN
• hu-HU
• hy-AM
• id-ID
• it-IT
• ja-JP
• ko-KR
• lt-LT
• lv-LV
• ms-MY
• nb-NO
• nl-NL
• pl-PL
• pt-BR
• pt-PT
• ro-RO
• ru-RU
• sv-SE
• th-TH
• tr-TR
• uk-UA
• ur-PK
• vi-VN

Error handling

The OnError event provides the custom ExceptionEventArgs information with the exceptions that the FCM can throw. It is triggered in the following scenarios:

• The integrator provides an invalid configuration (Yoti.FCM.FaceDetection.Exceptions.ConfigurationException).
• The webcam index is out of range (System.ArgumentOutOfRangeException).
• If the current webcam streaming is disconnected (Yoti.FCM.Exceptions.WebcamStreamException).
• Unexpected exceptions (System.Exception).

Other controls

Webcam selector

The package exports the method Yoti.FCM.WebcamStream.WebcamInfo.GetWebcamDevices() to get all webcam devices that are available. It also provides a user control to select a webcam:

<controls:WebcamSelector Width="300" Height="24" SelectionChanged="WebcamSelector_SelectionChanged" />

The properties for the webcam selector are the following:

Resolution selector

The package exports the method Yoti.FCM.WebcamStream.WebcamCapabilities.GetValidCapabilities(string webcamMoniker) to get all the capabilities compatible with the FCM for the provided device. It also provides a user control to select capabilities set:

<controls:ResolutionSelector Width="300" Height="24" SelectedWebcam="{Binding CurrentWebcam.MonikerString}" SelectionChanged="ResolutionSelector_SelectionChanged"/>

The properties for the webcam selector are the following: