Native Android

Introduction

The Android integration of the IntelliProve plug-in involves incorporating the IntelliProve SDK files into your project dependencies.

All this is nicely laid out in our step-by-step guide below.

The integration guide covers three sections:

1. Adding the SDK
2. Setting up the project
3. Usage

GitHub

Our GitHub repository provides a fully functional example of our platform’s integration, demonstrating the seamless setup and utilisation of our native SDKs for Android platforms.

https://github.com/IntelliProve/intelliprove-web-plugin-android

Adding the SDK

Last update 16/09/2025 09:35

IntelliProveWebView.aar

• All the following actions are taken in root folder of the project
• Add folder app/libs
• Copy the IntelliProveWebView.aar into this folder
• In app/build.gradle, add a dependency for the IntelliProveWebView.aarand androidx’s AppCompatibility ConstraintLayout.

dependencies {
    ...
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    implementation files('libs/IntelliProveWebView.aar')
}

Setting up the project

• In build.gradle, ensure the correct Kotlin version is used:

buildscript {
    ext.kotlin_version = '1.8.0'
    ...
}

• In app/build.gradle, define the minSdkVersion:

android {
    ...
    defaultConfig {
        ...
        minSdkVersion 24
        ...
    }
    ...
}

• In app/src/main/AndroidManifest.xml, add the needed permissions for Camera and Internet usage, and an activity tag, so the IntelliWebViewActivity can be shown in the application:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    ...

    <uses-feature
        android:name="android.hardware.camera"
        android:required="false" />

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.CAMERA" />

    ...

    <application ...>
        ...
        <activity
            android:name="com.intelliprove.webview.IntelliWebViewActivity"
            android:theme="@style/Theme.AppCompat.NoActionBar"
            />
        ...
    </application>
</manifest>

Usage

• Let the Activity inherit from the IntelliWebViewDelegate class, which provides the didReceivePostMessage delegate. (For more information on the postmessages, including the JSON format, refer to Message events.)
• Use the openWebView to open the web view with a URL for the Face Scan Plug-in.
  • Make sure to request the URL for the Face Scan plug-in using the Get Face Scan URL API endpoint.

Please note:

• The WebView is automatically dismissed by the SDK when receiving the dismiss post message.
• The SDK creates a new Activity, which means the entire screen is filled with the IntelliProve plug-in. For use cases where this is not desired, contact our support team for a more custom integration.

package com.intelliprove

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import android.widget.Button
import com.intelliprove.webview.IntelliWebViewActivity
import com.intelliprove.webview.IntelliWebViewDelegate

class MainActivity : AppCompatActivity(), IntelliWebViewDelegate {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val openWebViewButton = findViewById<Button>(R.id.openWebViewButton)
        openWebViewButton.setOnClickListener {
            openWebView()
        }
    }

    private fun openWebView() {
        IntelliWebViewActivity.start(
            this,
            "https://plugin-streaming.intelliprove.com/?action_token=xxx",
            this
        )
    }

    override fun didReceivePostMessage(postMessage: String) {
        Log.d("MainActivity", postMessage)
        // postMessage is received as JSON string, so needs to be parsed
    }
}

Next steps

• To match the plug-in with your brand’s colours and fonts, please visit our our UI Customization documentation.