> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-mobile/framework-plugins/extras/selphi/selphi-configuracion.md).

# Selphi Configuration

Possible configuration parameters

#### **livenessMode**

Sets the component's capture mode. Possible values are:

* ***SelphiFaceLivenessMode.NONE***: Indicates that photo detection mode must not be enabled in authentication processes.
* ***SelphiFaceLivenessMode.PASSIVE***: Indicates that the passive liveness check is performed on the server, with the corresponding "BestImage" sent for this purpose.
* ***SelphiFaceLivenessMode.MOVE***: Indicates that liveness testing is active: instructions are displayed during capture, and the corresponding process result is returned.

#### **debug**

Enables the component's debug mode.

#### **resourcesPath**

Specifies the name of the component's resources in ZIP format. Example: “resources-selphi-2-0.zip“.

This name is used to look for the file in the *assets*.

<div align="left"><figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-15ce71837bf3d4cff1f1509e00d49ef3c005ef31%2Fassets.png?alt=media" alt=""><figcaption></figcaption></figure></div>

**cropPercent**

Allows you to change the face crop percentage. The higher the value, the more the rectangle is cropped relative to the face.

#### **cropImageDebug**

Allows debug mode to check the face crop percentage.

#### **showResultAfterCapture**

Specifies whether to display a screen with the captured image after the analysis process. This screen allows the user to repeat the capture if the image obtained was not correct.

#### **showTutorial**

Specifies whether the Widget displays the tutorial screen. This view intuitively explains how to capture an image.

#### **livenessMode**

Sets the Widget's liveness mode. Allowed values are:

* SelphiFaceLivenessMode.NONE: Indicates that photo detection mode must not be enabled in authentication processes.
* SelphiFaceLivenessMode.PASSIVE: Indicates that the passive liveness check is performed on the server, with the corresponding “BestImage” or “TemplateRaw” sent for this purpose.
* SelphiFaceLivenessMode.MOVE: Indicates that liveness testing is active: instructions are displayed during capture, and the corresponding process result is returned.

#### **stabilizationMode**

Sets a stabilization mode before any authentication process in the Widget. With this mode enabled, the Widget will not start any process unless the user is facing forward with their head still.

#### **cameraFlashEnabled**

Specifies whether the device camera flash is enabled.

#### **locale**

Forces the Widget to use the language setting specified by the locale parameter. This parameter accepts either a language code (e.g., ‘en’) or a regional identifier (e.g., ‘en\_US’). If the Widget's resource file does not include a localization for the selected ‘locale’, the default language will be used instead.

#### **fullscreen**

Specifies whether the view should be displayed in full screen, if the system allows it.

#### **templateRawOptimized**

Specifies whether the template (templateRaw) generated after the selfie should be optimized.

#### **qrMode**

A Boolean indicating whether QR code scanning should be enabled before the authentication process.

#### **videoFilename**

Sets the absolute path and filename for recording a video of the capture process. The application is responsible for requesting any necessary permissions from the phone if the path requires additional permissions. By default, the Widget does not record anything unless a file path is specified using this method.

#### **viewsContent**

This advanced property allows you to configure the Widget's views using an XML-formatted string.

Note: This property does not alter the contents of the resource file.

#### **showDiagnostic**

Show diagnostic screens at the end of the process

#### **logImages**

When enabled, returns a list of the 5 best images captured of the user.

#### **showPreviousTip**

Displays a screen before capture starts, with information about the process to be performed and a button to start it.

#### **extractionDuration**

Duration of the facial extraction process. Possible values:

* SelphiExtractionDuration.SHORT
* SelphiExtractionDuration.MEDIUM
* SelphiExtractionDuration.LONG

#### **cameraPreferred**

Camera to use for the process: FRONT, BACK

#### **vibrationEnabled**

Indicates whether vibration feedback is desired when the process ends.

#### **moveSuccessfulAttempts**

Number of retries for a successful capture during the movement process (default: 1)

#### **moveFailedAttempts**

Number of retries for an unsuccessful capture during the movement process (default: 2)
