Android SDK 1.2.3

SDK Installation

1. Download the Android SDK and sample code here.
2. Unzip the downloaded SDK zip file to a folder in your local drive.

Sample Code

The quickest and simplest way to kickstart your journey with the Android SDK is by downloading and experimenting with our sample code. Follow these steps to open the sample project:

1. Open Android Studio.
2. In Android Studio, select "File", "Open...".
3. Choose the demo folder from the downloaded SDK files, and then click Open.

IMPORTANT

In the demo code, the strings __YOUR_USER_ID__ and __YOUR_API_KEY__ should be replaced by your own User ID and API Key repectively. Please contact us to obtain your User ID and API Key.

Project Integration

IMPORTANT

Please note that for Android, the minimum SDK version must be at least 24.

1. Add the following line to the file settings.gradle:

   Kotlin (build.gradle.kts)

   include(":vital-sign-engine")
   project(":vital-sign-engine").projectDir = File("path_of_downloaded_folder/kotlin-vital-sign-sdk-1.2.3/sdk/libs")
   include(":vital-sign-sdk")
   project(":vital-sign-sdk").projectDir = File("path_of_downloaded_folder/kotlin-vital-sign-sdk-1.2.3/sdk")

   Groovy (build.gradle)

   include ':vital-sign-engine'
   project(':vital-sign-engine').projectDir = new File('path_of_downloaded_folder/kotlin-vital-sign-sdk-1.2.3/sdk/libs')
   include ':vital-sign-sdk'
   project(':vital-sign-sdk').projectDir = new File('path_of_downloaded_folder/kotlin-vital-sign-sdk-1.2.3/sdk')

   Please replace the string path_of_downloaded_folder above with the actual downloaded path.

2. Remove or comment out the line which set the repositories mode to RepositoriesMode.FAIL_ON_PROJECT_REPOS from the file settings.gradle.kts or settings.gradle:

   Kotlin (build.gradle.kts)

   dependencyResolutionManagement {
   //    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
       }
   }

   Groovy (build.gradle)

   dependencyResolutionManagement {
   //    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
       }
   }

3. Add the dependencies in the file build.gradle.kts or build.gradle.

   Kotlin (build.gradle.kts)

   implementation(project(":vital-sign-engine"))
   implementation(project(":vital-sign-sdk"))

   Groovy (build.gradle)

   implementation project(path: ':vital-sign-engine')
   implementation project(path: ':vital-sign-sdk')

Camera Permission

When developing for Android, you need to allow the app to use the camera by specifying the following in AndroidManifest.xml:

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

What's New

1.2.3 (9-Sept-2025)

• Fixed an issue where the dummy face detector caused the V2 server to not return results.

1.2.2 (19-Aug-2025)

• Added dummy face detector

1.2.1 (18-Aug-2025)

• Added ConditionCheckerConfig

1.2.0 (8-May-2025)

• Introduced support for Server version 3.9.0 (Schema 1.5), featuring the new Cholesterol Risk functionality (Beta). To calculate cholesterol risk, the UserInfo object now requires the additional property alcoholic. For example:

    userInfo = UserInfo().apply {
        // ...
        alcoholic = false
    }

• Bug fixes and improvements