Skip to main content

builder

FaceRecognition.Builder

| Parameter | Function | Required | | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---- | | mobileToken | Client key that identifies that the collected data comes from your application. If you have not yet received your mobile-token, contact support. | Yes. | | .setSandboxEnvironment() | If this parameter is used in the constructor, the library will be configured to send data to the sandbox environment. If absent, requests are sent to the production environment. | No. | | .showIntroductionScreens(Boolean showIntroductionScreens) | When "false" disables the introduction screens for photo capture that appear to the user. | No. Default is "true". | | .setShowSuccessScreen(Boolean showSuccessScreen) | When "false" disables the success screen after photo capture. | No. Default is "true". | | .setBackgroundColor(String backgroundColor) | Allows configuration of the background color of the SDK activities. | No. Default is "#ffffff". | | .setFontColor(String fontColor) | Allows configuration of the font and icon color of the SDK activities. | No. Default is "#000000". | | .setFontFamily(FontFamily fontFamily) | Allows configuration of the font of the SDK activities. | No. If not specified, the default is FontFamily.open_sans. Available fonts: FontFamily.open_sans, FontFamily.futura, FontFamily.verdana, FontFamily.roboto, FontFamily.poppins and FontFamily.helvetica. | No. | | .activeFaceLiveness(Boolean activeFaceLiveness) | Indicates whether the SDK should perform a user selfie capture procedure or active proof of life. | No. Default is false. | | .audioConfiguration(AudioConfiguration audioConfiguration) | Indicates whether the SDK should or should not execute indication audios for the user. Accepted configurations are AudioConfiguration.enable which executes indication audios, AudioConfiguration.disable which does not execute these audios and AudioConfiguration.accessibility which executes audios if the user's device has accessibility settings enabled. | No. Default is AudioConfiguration.disable. | | .setVisualConfiguration(VisualConfiguration. visualConfiguration) | Used to customize the images shown to the user throughout the SDK execution. | No. | | .setTextConfiguration(TextConfiguration. textConfiguration) | Used to customize the introductory onboarding screen texts shown to the user throughout the SDK execution. | No. | | .setSessionId(String sessionId) | Used to define the key that identifies the session started in the SDK. It is used to track the entire flow taken by the user in the FaceRecon execution through logs. This field accepts up to 255 characters. | No. | | .setLogLevel(FaceRecognition.LogLevel logLevel) | Used to customize the verbosity level of the SDK logs. Available levels: LogLevel.debug, LogLevel.info, LogLevel.warn, LogLevel.error and LogLevel.trace. Default is LogLevel.debug. | No. | | .setDocumentNumber(String documentNumber) | Used to define the user's document number. This field accepts 14 characters of CPF formatted as follows 000.000.000-00 | Yes in all calls if using 1:1 validation at some point. | | .setValidation(Boolean validation) | Used to define whether the SDK should or should not perform 1:1 validation with the user's selfie. In the user's first session this flag must be, mandatorily false. This function requires the setDocumentNumber method to be filled. | No. Default is false. |

The VisualConfiguration Object

ParameterFunctionRequired
.setOnboardingDrawable(int onboarding_drawable, int onboarding_width)Used to configure the image shown to the user on the SDK onboarding screen. The onboarding_drawable parameter should reference the id of the image to be shown and onboarding_width is the desired display size of this image.No.
.setButtonBorderSize(int border_size)Used to configure the border width of the SDK buttons.No. Default is 1.
.setButtonShadow(boolean button_shadow)When set to false removes the shadow effect, default on android, used by the SDK buttons.No. Default is true.

The TextConfiguration Object

ParameterFunctionRequired
.setCustomText(CustomLabel label, String text)Used to configure the texts shown to the user on the SDK onboarding screenNo.