# Customizing Android SDK
## Configuration
We recommend applying these settings when starting the app.
{% tabs %}
{% tab title="Kotlin" %}
```kotlin
// connecting to the API server
OzLivenessSDK.setApiConnection(OzConnection.fromServiceToken(HOST, TOKEN))
// settings for the number of attempts to detect an action
OzLivenessSDK.config.attemptSettings = attemptSettings
// the possibility to display additional debug information (you can do it by clicking the SDK version number)
OzLivenessSDK.config.allowDebugVisualization = allowDebugVisualization
// logging settings
OzLivenessSDK.config.logging = ozLogging
```
{% endtab %}
{% tab title="Java" %}
```java
OzConfig config = OzLivenessSDK.INSTANCE.getConfig();
// connecting to the API server
OzLivenessSDK.setApiConnection(OzConnection.fromServiceToken(HOST, TOKEN));
// settings for the number of attempts to detect an action
config.setAttemptSettings(attemptSettings);
// the possibility to display additional debug information (you can do it by clicking the SDK version number)
config.setAllowDebugVisualization(allowDebugVisualization);
// logging settings
config.setLogging(ozLogging);
```
{% endtab %}
{% endtabs %}
## Interface Customization
To customize the Oz Liveness interface, use `UIcustomization` as shown below. For the description of customization parameters, please refer to [Android SDK Methods and Properties](https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/sdk/oz-mobile-sdk/android/pages/VCUMVrFbFl9Y2E7Flmdx#h.c69s4peyk55n-1).
{% tabs %}
{% tab title="Kotlin" %}
OzLivenessSDK.config.customization = UICustomization(
// customization parameters for the toolbar
toolbarCustomization = ToolbarCustomization(
closeIconRes = R.drawable.ib_close,
closeIconTint = Color.ColorRes(R.color.white),
titleTextFont = R.font.roboto,
titleTextSize = 18,
titleTextAlpha = 100,
titleTextColor = Color.ColorRes(R.color.white),
backgroundColor = Color.ColorRes(R.color.black),
backgroundAlpha = 60,
isTitleCentered = true,
title = "Analysis",
),
// customization parameters for the center hint
centerHintCustomization = CenterHintCustomization(
textFont = R.font.roboto,
textColor = Color.ColorRes(R.color.text_color),
textSize = 20,
verticalPosition = 50,
textStyle = R.style.Sdk_Text_Primary,
backgroundColor = Color.ColorRes(R.color.color_surface),
backgroundOpacity = 56,
backgroundCornerRadius = 14,
textAlpha = 100,
),
// customization parameters for the hint animation
hintAnimation = HintAnimation(
hintGradientColor = Color.ColorRes(R.color.red),
hintGradientOpacity = 80,
animationIconSize = 120,
hideAnimation = false,
),
// customization parameters for the frame around the user face
faceFrameCustomization = FaceFrameCustomization(
geometryType = GeometryType.Rectangle(10), // 10 is the corner radius
strokeDefaultColor = Color.ColorRes(R.color.error_red),
strokeFaceInFrameColor = Color.ColorRes(R.color.success_green),
strokeAlpha = 100,
strokeWidth = 5,
strokePadding = 3,
),
// customization parameters for the background outside the frame
backgroundCustomization = BackgroundCustomization(
backgroundColor = Color.ColorRes(R.color.black),
backgroundAlpha = 60,
),
// customization parameters for the SDK version text
versionTextCustomization = VersionTextCustomization(
textFont = R.font.roboto,
textSize = 12,
textColor = Color.ColorRes(R.color.white),
textAlpha = 100,
),
// customization parameters for the antiscam protection text
antiScamCustomization = AntiScamCustomization(
textMessage = "",
textFont = R.font.roboto,
textSize = 14,
textColor = Color.ColorRes(R.color.text_color),
textAlpha = 100,
backgroundColor = Color.ColorRes(R.color.color_surface),
backgroundOpacity = 100,
cornerRadius = 20,
flashColor = Color.ColorRes(R.color.green),
),
// custom logo parameters
// should be allowed by license
logoCustomization = LogoCustomization(
image = Image.Drawable(R.drawable.ic_logo),
size = Size(176, 64),
verticalPosition = 100,
horizontalPosition = 50,
)
)
{% endtab %}
{% tab title="Java" %}
```java
OzLivenessSDK.INSTANCE.getConfig().setCustomization(new UICustomization(
// customization parameters for the toolbar
new ToolbarCustomization(
R.drawable.ib_close,
new Color.ColorRes(R.color.white),
R.style.Sdk_Text_Primary,
new Color.ColorRes(R.color.white),
R.font.roboto,
Typeface.NORMAL,
100, // toolbar text opacity (in %)
18, // toolbar text size (in sp)
new Color.ColorRes(R.color.black),
60, // toolbar alpha (in %)
"Liveness", // toolbar title
true // center toolbar title
),
// customization parameters for the center hint
new CenterHintCustomization(
R.font.roboto,
new Color.ColorRes(R.color.text_color),
20,
50,
R.style.Sdk_Text_Primary,
new Color.ColorRes(R.color.color_surface),
100, // background opacity
14, // corner radius for background frame
100 // text opacity
),
// customization parameters for the hint animation
new HintAnimation(
new Color.ColorRes(R.color.red), // gradient color
80, // gradient opacity (in %)
120, // the side size of the animation icon square
false // hide animation
),
// customization parameters for the frame around the user face
new FaceFrameCustomization(
GeometryType.RECTANGLE,
10, // frame corner radius (for GeometryType.RECTANGLE)
new Color.ColorRes(R.color.error_red),
new Color.ColorRes(R.color.success_green),
100, // frame stroke alpha (in %)
5, // frame stroke width (in dp)
3 // frame stroke padding (in dp)
),
// customization parameters for the background outside the frame
new BackgroundCustomization(
new Color.ColorRes(R.color.black),
60 // background alpha (in %)
),
// customization parameters for the SDK version text
new VersionTextCustomization(
R.style.Sdk_Text_Primary,
R.font.roboto,
12, // version text size
new Color.ColorRes(R.color.white),
100 // version text alpha
),
// customization parameters for the antiscam protection text
new AntiScamCustomization(
"Recording .. ",
R.font.roboto,
12,
new Color.ColorRes(R.color.text_color),
100,
R.style.Sdk_Text_Primary,
new Color.ColorRes(R.color.color_surface),
100,
14,
new Color.ColorRes(R.color.green)
)
// custom logo parameters
new LogoCustomization(
new Image.Drawable(R.drawable.ic_logo),
new Size(176, 64),
100,
50
)
)
);
```
{% endtab %}
{% endtabs %}
By default, SDK uses the locale of the device. To switch the locale, use the code below:
{% tabs %}
{% tab title="Kotlin" %}
```kotlin
OzLivenessSDK.config.localizationCode = OzLivenessSDK.OzLocalizationCode.EN
```
{% endtab %}
{% tab title="Java" %}
```java
OzLivenessSDK.INSTANCE.getConfig().setLocalizationCode(OzLivenessSDK.OzLocalizationCode.EN)
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.ozforensics.com/oz-knowledge/guides/developer-guide/sdk/oz-mobile-sdk/android/customizing-android-sdk.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.