Skip to main content

Customization

Markdown
Capture flow availability

These customizations are only available when the capture flow is liveness.

The Android SDK supports two dimensions of customization: language and colors.

Language

Configure the language of informational messages in the capture frames via the setLocale method:

acessoBioBuilder.setLocale(LocaleTypes.EN_US)

Refer to API Reference > Enums for the full list of supported LocaleTypes values.

Colors

Apply a custom theme using setTheme on acessoBioBuilder. Color values can be passed as a Color Resource (R.color.your_color) or a hexadecimal String ("#FF0000").

The IAcessoBioTheme interface exposes different methods depending on the capture type.

Selfie capture
MethodWhat it customizes
getColorBackground()Background color of the selfie capture frame
getColorBoxMessage()Background color of the message box
getColorTextMessage()Text color inside the message box
getColorSilhouetteSuccess()Color of the silhouette when capture succeeds
val unicoTheme = object : IAcessoBioTheme {
override fun getColorBackground() = R.color.your_color
override fun getColorBoxMessage() = R.color.your_color
override fun getColorTextMessage() = R.color.your_color
override fun getColorSilhouetteSuccess() = R.color.your_color
}
acessoBioBuilder.setTheme(unicoTheme)

Alternatively, override the colors statically in your colors.xml:

<color name="unico_color_background">#YourColor</color>
<color name="unico_color_box_message">#YourColor</color>
<color name="unico_color_text_message">#YourColor</color>
<color name="unico_color_silhouette_success">#YourColor</color>
<color name="unico_color_button_cancel">#YourColor</color>
info

unico_color_button_cancel is only available via colors.xml — it is not exposed as a method in IAcessoBioTheme.

Document capture
warning

For security reasons, Android SDK 6.13.0 and later no longer include the native document capture. The public API still exists for now, but calling it returns error 73905, "Unable to open document camera". It will be removed in an upcoming version. For more information, contact your CSM.

MethodWhat it customizes
getColorBackground()Background color of the document capture frame
getColorBackgroundTakePictureButton()Background color of the take-picture button
getColorIconTakePictureButton()Icon color inside the take-picture button
getColorBackgroundBottomDocument()Deprecated. No effect since Android SDK 6.13.0. Background color of the bottom bar
getColorTextBottomDocument()Deprecated. No effect since Android SDK 6.13.0. Text color in the bottom bar
val unicoTheme = object : IAcessoBioTheme {
override fun getColorBackground() = R.color.your_color
override fun getColorBackgroundTakePictureButton() = R.color.your_color
override fun getColorIconTakePictureButton() = R.color.your_color
override fun getColorBackgroundBottomDocument() = R.color.your_color
override fun getColorTextBottomDocument() = R.color.your_color
}
acessoBioBuilder.setTheme(unicoTheme)

Alternatively, override the colors statically in your colors.xml:

<color name="unico_color_background">#YourColor</color>
<color name="unico_color_background_take_picture_button">#YourColor</color>
<color name="unico_color_icon_take_picture_button">#YourColor</color>
<color name="unico_color_background_bottom_document">#YourColor</color> <!-- Deprecated. No effect since Android SDK 6.13.0. -->
<color name="unico_color_text_bottom_document">#YourColor</color> <!-- Deprecated. No effect since Android SDK 6.13.0. -->
Customization scope

No other customization dimensions are available. Custom UI behavior and layout are not offered by the native Android SDK. If you need a proprietary UI, refer to the Capture Standard option (headless API integration).