Android SDK 1.4.1

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.4.1/sdk/libs")
   include(":vital-sign-sdk")
   project(":vital-sign-sdk").projectDir = File("path_of_downloaded_folder/kotlin-vital-sign-sdk-1.4.1/sdk")

   Groovy (build.gradle)

   include ':vital-sign-engine'
   project(':vital-sign-engine').projectDir = new File('path_of_downloaded_folder/kotlin-vital-sign-sdk-1.4.1/sdk/libs')
   include ':vital-sign-sdk'
   project(':vital-sign-sdk').projectDir = new File('path_of_downloaded_folder/kotlin-vital-sign-sdk-1.4.1/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.4.1 (5-Sept-2025)

• Fixed the problem that the blink detector is not working.

1.4.0 (4-Sept-2025)

• Introduced SdkCredentials, providing a new method for setting the API key and user ID.
• Added PrecisionMode. The relaxed mode uses the V1 server and performs measurements in best-effort mode, while the strict mode uses the V2 server for high-accuracy measurements, requiring higher device performance.
• Added support for 16KB page size to comply with Android requirements.
• Various bug fixes and general improvements.