Android SDK guide

allprojects {
   repositories {
       maven { url "https://cdn.veriff.me/android/" }
       google()
       mavenCentral()
   }
}

dependencyResolutionManagement {
    repositories {
        maven { url "https://cdn.veriff.me/android/" }
        google()
        mavenCentral()
    }
}

implementation 'com.veriff:veriff-library:$latestVeriffAndroidSdkVersion'

import com.veriff.Sdk;

Intent intent = Sdk.createLaunchIntent(activity, sessionUrl);
startActivityForResult(intent, REQUEST_CODE);

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (requestCode == REQUEST_CODE) {
        Result result = Result.fromResultIntent(data);
        if (result != null) {
            handleResult(result); //see below for handling the result
        }
    }
    super.onActivityResult(requestCode, resultCode, data);
}

public void handleResult(Result result) {
    switch (result.getStatus()) {
    case DONE:
        // The end-user successfully submitted the session, the session is completed from their perspective
        break;
    case CANCELED:
        // The end-user canceled the verification process
        break;
    case ERROR:
        // An error occurred during the flow, Veriff has already shown UI, no need to display
        // a separate error message here
        Log.w(TAG, "Verification error occurred: " + result.getError());
        break;
    }
}

Sdk.setLogger(myLoggerImplementation);
Intent intent = Sdk.createLaunchIntent(activity, sessionUrl);
startActivityForResult(intent, REQUEST_CODE);

Branding branding = new Branding.Builder()
        .logo(R.drawable.logo)
        // Screen and dialog background color
        .background(getResources().getColor(R.color.background_color))
        // Non-surface content (such as text, icons) displayed on `background`.
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `background`
        .onBackground(getResources().getColor(R.color.on_background_color))
        // Secondary non-surface content (such as text) displayed on `background`.
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `background`
        .onBackgroundSecondary(getResources().getColor(R.color.on_background_secondary_color))
        // Tertiary non-surface content (such as text) displayed on `background`.
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `background`
        .onBackgroundTertiary(getResources().getColor(R.color.on_background_tertiary_color))
        // Primary surfaces (such as buttons) displayed on `background`.
        // Accessibility: Must have a contrast ratio of at least 3:1 vs `background`
        .primary(getResources().getColor(R.color.primary_color))
        // Non-surface content (such as text) displayed on `primary` surfaces.
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `primary`
        .onPrimary(getResources().getColor(R.color.on_primary_color))
        // Secondary surfaces (such as bullet points and illustrations) displayed on `background`.
        // Accessibility: Must have a contrast ratio of at least 3:1 vs `background`
        .secondary(getResources().getColor(R.color.secondary_color))
        // Non-surface content (such as text) displayed on `secondary` surfaces.
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `secondary`
        .onSecondary(getResources().getColor(R.color.on_secondary_color))
        // Backgroung color of the overlay area on all the screens with camera
        .cameraOverlay(getResources().getColor(R.color.camera_overlay_color))
        // All UI elements on all the screens with camera on top of camera overlay
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `cameraOverlay`
        .onCameraOverlay(getResources().getColor(R.color.on_camera_overlay_color))
        // Color used for various outlines and boundaries of UI elements
        .outline(getResources().getColor(R.color.outline_color))
        // Error indicators (such as text, borders, icons) displayed on `background`
        // Accessibility: Must have a contrast ratio of at least 4.5:1 vs `background`
        .success(getResources().getColor(R.color.success_color))
        // Success indicators (such as borders, icons) displayed on `background`
        // Accessibility: Must have a contrast ratio of at least 3:1 vs `background`
        .error(getResources().getColor(R.color.error_color))
        // Button corner radius, in `dp`
        .buttonRadius(48f)
        .build();

Configuration configuration = new Configuration.Builder()
        .branding(branding)
        .build();


Intent intent = Sdk.createLaunchIntent(activity, sessionUrl, configuration);
startActivityForResult(intent, REQUEST_CODE);

brandingBuilder.font(
    new com.veriff.Font.Builder()
        .setRegular(R.font.comic_neue_regular)
        .setMedium(R.font.comic_neue_medium)
        .setBold(R.font.comic_neue_bold)
        .build()
);

Configuration configuration = new Configuration.Builder()
        .customIntroScreen(true)
        .build();

Locale appLocale = Locale.ENGLISH;
Configuration configuration = new Configuration.Builder()
        .locale(appLocale)
        .build();

Intent intent = Sdk.createLaunchIntent(activity, sessionUrl, configuration);
startActivityForResult(intent, REQUEST_CODE);

Branding lightBranding = new Branding.Builder()
    // Background Colors
    .background(Color.WHITE)  // #FFFFFF

    // Primary Brand Colors
    .primary(Color.parseColor("#03282C"))      // Dark teal
    .secondary(Color.parseColor("#14E5C5"))    // Light teal/cyan

    // Content on Light Background
    .onBackground(Color.parseColor("#03282C"))          // Dark text
    .onBackgroundSecondary(Color.parseColor("#757575")) // Gray text
    .onBackgroundTertiary(Color.parseColor("#11615C"))  // Muted text

    // Primary Button Colors
    .onPrimary(Color.WHITE)                            // White text on primary
    .onSecondary(Color.parseColor("#03282C"))           // Dark text on secondary

    // Camera Screen
    .cameraOverlay(Color.parseColor("#03282C"))         // Dark overlay
    .onCameraOverlay(Color.WHITE)                       // White text

    // Feedback & Borders
    .outline(Color.parseColor("#919191"))               // Gray borders
    .error(Color.parseColor("#E02006"))                 // Red error
    .success(Color.parseColor("#5BC868"))               // Green success

    // Styling
    .buttonRadius(48f)  // Fully rounded buttons
    .logo(R.drawable.my_logo_light)
    .notificationIcon(R.drawable.ic_notification)

    .build();

Branding darkBranding = new Branding.Builder()
    // Background Colors
    .background(Color.parseColor("#03282C"))  // Dark background

    // Primary Brand Colors (More vibrant in dark mode)
    .primary(Color.parseColor("#14E5C5"))     // Bright teal/cyan
    .secondary(Color.parseColor("#14E5C5"))   // Same bright teal

    // Content on Dark Background
    .onBackground(Color.WHITE)                             // White text
    .onBackgroundSecondary(Color.parseColor("#B0B0B0"))   // Light gray
    .onBackgroundTertiary(Color.parseColor("#14E5C5"))    // Brand color accent

    // Primary Button Colors
    .onPrimary(Color.parseColor("#03282C"))  // Dark text on bright primary
    .onSecondary(Color.WHITE)               // White text on secondary

    // Camera Screen
    .cameraOverlay(Color.BLACK)             // Pure black overlay
    .onCameraOverlay(Color.WHITE)           // White text

    // Feedback & Borders
    .outline(Color.parseColor("#505050"))    // Dark gray borders
    .error(Color.parseColor("#FF6B6B"))      // Bright red
    .success(Color.parseColor("#69DB7C"))    // Bright green

    // Styling
    .buttonRadius(48f)
    .logo(R.drawable.my_logo_dark)  // Light-colored logo for dark background
    .notificationIcon(R.drawable.ic_notification)

    .build();

import android.content.res.Configuration

fun isSystemDarkModeEnabled(context: Context): Boolean {
    val isDarkMode = when (context.resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK) {
        Configuration.UI_MODE_NIGHT_YES -> true
        Configuration.UI_MODE_NIGHT_NO -> false
        else -> false
    }
    return isDarkMode
}

// Usage in Activity
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    val isDarkMode = isSystemDarkModeEnabled(this)
    val branding = if (isDarkMode) darkBranding else lightBranding
    
    // Pass branding to Veriff SDK
    startVeriffFlow(branding)
}

import android.content.res.Configuration;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MyActivity extends AppCompatActivity {

    // Define theme configurations
    private final Branding lightBranding = new Branding.Builder()
        .background(Color.WHITE)
        .primary(Color.parseColor("#03282C"))
        .secondary(Color.parseColor("#14E5C5"))
        .onBackground(Color.parseColor("#03282C"))
        .onBackgroundSecondary(Color.parseColor("#757575"))
        .onBackgroundTertiary(Color.parseColor("#11615C"))
        .onPrimary(Color.WHITE)
        .onSecondary(Color.parseColor("#03282C"))
        .cameraOverlay(Color.parseColor("#03282C"))
        .onCameraOverlay(Color.WHITE)
        .outline(Color.parseColor("#919191"))
        .error(Color.parseColor("#E02006"))
        .success(Color.parseColor("#5BC868"))
        .buttonRadius(48f)
        .logo(R.drawable.logo_light)
        .build();

    private final Branding darkBranding = new Branding.Builder()
        .background(Color.parseColor("#03282C"))
        .primary(Color.parseColor("#14E5C5"))
        .secondary(Color.parseColor("#14E5C5"))
        .onBackground(Color.WHITE)
        .onBackgroundSecondary(Color.parseColor("#B0B0B0"))
        .onBackgroundTertiary(Color.parseColor("#14E5C5"))
        .onPrimary(Color.parseColor("#03282C"))
        .onSecondary(Color.WHITE)
        .cameraOverlay(Color.BLACK)
        .onCameraOverlay(Color.WHITE)
        .outline(Color.parseColor("#505050"))
        .error(Color.parseColor("#FF6B6B"))
        .success(Color.parseColor("#69DB7C"))
        .buttonRadius(48f)
        .logo(R.drawable.logo_dark)
        .build();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Detect system theme and apply appropriate branding
        Branding branding = getThemeAwareBranding();

        // Launch Veriff with appropriate branding
        launchVeriff(branding);
    }

    private Branding getThemeAwareBranding() {
        int uiMode = getResources().getConfiguration().uiMode
                & Configuration.UI_MODE_NIGHT_MASK;

        boolean isDarkMode = (uiMode == Configuration.UI_MODE_NIGHT_YES);

        return isDarkMode ? darkBranding : lightBranding;
    }

    private void launchVeriff(Branding branding) {
        Bundle sessionBundle = new Bundle();
        sessionBundle.putString("SESSION_TOKEN", "your_session_token");
        // Pass branding to Veriff SDK

        // Start Veriff activity with branding
        // Implementation depends on your Veriff SDK integration method
    }
}

// ThemeConfig.java
public class ThemeConfig {

    public final String name;
    public final int primary;
    public final int secondary;
    public final int background;
    public final int onBackground;
    public final int onBackgroundSecondary;
    public final int onBackgroundTertiary;
    public final int cameraOverlay;
    public final int onCameraOverlay;
    public final int outline;
    public final int error;
    public final int success;
    public final int onPrimary;
    public final int onSecondary;
    public final float buttonRadius;

    public ThemeConfig(
            String name,
            int primary,
            int secondary,
            int background,
            int onBackground,
            int onBackgroundSecondary,
            int onBackgroundTertiary,
            int cameraOverlay,
            int onCameraOverlay,
            int outline,
            int error,
            int success,
            int onPrimary,
            int onSecondary,
            float buttonRadius
    ) {
        this.name = name;
        this.primary = primary;
        this.secondary = secondary;
        this.background = background;
        this.onBackground = onBackground;
        this.onBackgroundSecondary = onBackgroundSecondary;
        this.onBackgroundTertiary = onBackgroundTertiary;
        this.cameraOverlay = cameraOverlay;
        this.onCameraOverlay = onCameraOverlay;
        this.outline = outline;
        this.error = error;
        this.success = success;
        this.onPrimary = onPrimary;
        this.onSecondary = onSecondary;
        this.buttonRadius = buttonRadius;
    }

    // Overload with default buttonRadius = 8f
    public ThemeConfig(String name, int primary, int secondary, int background,
            int onBackground, int onBackgroundSecondary, int onBackgroundTertiary,
            int cameraOverlay, int onCameraOverlay, int outline, int error,
            int success, int onPrimary, int onSecondary) {
        this(name, primary, secondary, background, onBackground,
             onBackgroundSecondary, onBackgroundTertiary, cameraOverlay,
             onCameraOverlay, outline, error, success, onPrimary, onSecondary, 8f);
    }

    public Branding toBranding() {
        return new Branding.Builder()
            .primary(primary)
            .secondary(secondary)
            .background(background)
            .onBackground(onBackground)
            .onBackgroundSecondary(onBackgroundSecondary)
            .onBackgroundTertiary(onBackgroundTertiary)
            .cameraOverlay(cameraOverlay)
            .onCameraOverlay(onCameraOverlay)
            .outline(outline)
            .error(error)
            .success(success)
            .onPrimary(onPrimary)
            .onSecondary(onSecondary)
            .buttonRadius(buttonRadius)
            .build();
    }
}

// Usage
Map<String, ThemeConfig> themes = new HashMap<>();
themes.put("light", new ThemeConfig("light", /* colors... */));
themes.put("dark",  new ThemeConfig("dark",  /* colors... */));

ThemeConfig selectedTheme = isDarkMode ? themes.get("dark") : themes.get("light");
Branding branding = selectedTheme != null ? selectedTheme.toBranding() : null;

implementation('com.veriff:veriff-library:6.+') {
    exclude group: 'com.veriff', module: 'mlkit'
}