Aldus SDK is a Peer-to-peer, Feature-rich, Realtime Identity Verification Solution through Video Chat.

The Video Customer Identification Process (V-CIP) can be integrated into your existing App flow and connects to the Aldus Web Client.

Available features

• Secure and Live P2P Video Chat with recording
• Screen Sharing
• Face & ID Capture
• Geo-Tagging
• Anti-Spoof Liveliness check

You can find the latest version and release history Here

• Prerequisite
• Android SDK Requirements
• Download
  • Using maven repository
• Setup
  • Permissions
• Quick Start
  • Invoking the Aldus Sdk
  • Handling the result
• Aldus Result
• Aldus Error Codes
• Aldus Parameters
• Help

The Aldus Android SDK communicates with its web counterpart, the Aldus Web Client. Make sure to have integrated the Aldus Web Client so that a Peer-to-peer connection can be established.

You will need a valid license to use the Aldus SDK, which can be obtained by contacting support@frslabs.com . Once you have the license , follow the below instructions for a successful integration of Aldus SDK onto your Android Application.

Minimum SDK Version - 21

Compile SDK Version - 28

Target SDK Version - 28

Add the following code to your project level build.gradle file

allprojects { 
    repositories { 
       maven { 
            // Maven Url and Credentials for Aldus SDK. 
            url "https://aldus-android.repo.frslabs.space/"                  
            credentials { 
                   username 'repo-username' 
                   password 'repo-password' 
            }
       }
       
        maven {
            // Maven Url and Credentials for Octus Aadhaar Offline SDK.
            url "https://octus-android-aadhaar-offline.repo.frslabs.space/"
            credentials {
                   username 'repo-username' 
                   password 'repo-password' 
            }
        }
        
        maven {
            // Maven Url and Credentials for FRSLABS WebRTC SDK
            url "https://frslabs-webrtc.repo.frslabs.space/"
            credentials {
                username 'repo-username' 
                password 'repo-password' 
            }
        }
        
    }
}

After that, add the following code to your app level build.gradle file

// ...

  defaultConfig { 
  
      // ...
      
      ndk { 
          abiFilters "armeabi-v7a", "arm64-v8a", "x86", "x86_64" 
      } 
      
  }

// ...

  compileOptions {
       sourceCompatibility = 1.8
       targetCompatibility = 1.8
  }

// ...

And then, add the dependencies

// ...

dependencies {
    /* Dependencies for Aldus SDK */ 
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support:design:<version above 23.4.0>'      
    implementation 'com.android.support.constraint:constraint-layout:<version above 1.1.3>'
   
    //Aldus Sdk Dependencies
    implementation 'com.frslabs.android.sdk:aldus:1.2.2' 
    implementation 'com.frslabs.android.sdk:webrtc:1.0.0'
    implementation 'com.squareup.okhttp3:okhttp:4.2.0'
    
    //Octus Aadhaar Offline
    implementation 'com.frslabs.android.sdk.octus:aadhaaroffline:1.0.6'
    implementation 'net.lingala.zip4j:zip4j:1.3.2'
    implementation 'com.google.code.gson:gson:2.8.6'
    
}

Aldus uses the required permissions to operate

    <!--Permissions-->
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

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

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

    <!--Features-->
    <uses-feature android:name="android.hardware.camera" android:required="true" />
    <uses-feature android:name="android.hardware.camera.front" android:required="true" />
    <uses-feature android:name="android.hardware.microphone" />

Initialize the Aldus instance with the appropriate configurations to invoke the Aldus Sdk

public class MainActivity extends AppCompatActivity implements AldusResultCallback {

    // ...

    /* Enter the Aldus license key here */
    private String ALDUS_LICENSE_KEY = "ENTER_YOUR_LICENSE_KEY_HERE";
    private String OCTUS_AADHAAR_OFFLINE_LICENSE_KEY = "ENTER_YOUR_LICENSE_KEY_HERE";
    private String ALDUS_URL = "ENTER_YOUR_ALDUS_URL_HERE";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button callSdk = findViewById(R.id.call_sdk);
        callSdk.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                /* Invoke the Aldus Sdk */
                callAldusSdk();
            }
        });
    }

    public void callAldusSdk() {

        //Initialize the Aldus Sdk Config object with the appropriate configurations
        AldusConfig aldusConfig = new AldusConfig.Builder()
                .setLicenseKey(ALDUS_LICENSE_KEY)
                .setOctusAadhaarOfflineLicenseKey(OCTUS_AADHAAR_OFFLINE_LICENSE_KEY)
                .setApiCredentials(new AldusApiCredentials(ALDUS_URL))
                .build();

        //Call the Aldus Sdk 
        Aldus aldus = new Aldus(aldusConfig);
        aldus.start(this, this);
        
    }

    // ...

}

Your activity must implement AldusResultCallback to receive the result.

    // ...

    @Override
    public void onAldusSuccess(AldusResult aldusResult) {
        Toast.makeText(this, "SessionId: "+aldusResult.getSessionId(), Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onAldusFailure(AldusErrorCode aldusErrorCode) {
        /* Handle the Aldus Sdk failure result here */
        Toast.makeText(this, "Error " + aldusErrorCode.toString(), Toast.LENGTH_SHORT).show();
    }

    // ...

The result is obtained through the AldusResult object

Given below is the Result classes in brief.

Error codes and their meaning are tabulated below

• setLicenseKey(String aldusLicenseKey) (Required)

  Accepts the Aldus licence key as a String

• setOctusAadhaarOfflineLicenseKey(String octusAadhaarOfflineLicenseKey) (Required)

  Accepts the Octus-Aadhaar-Offline licence key as a String

• setApiCredentials(AldusApiCredentials aldusApiCredentials) (Required)

  Sets the AldusApiCredentials , required for networking inside the Aldus SDK

• setTermsAndConditionsUrl(String termsAndConditionsUrl) (Optional)

  Sets the termsAndConditionsUrl in the Terms And Conditions Screen. If not set , only the basic text is displayed.

• setInitialConnectionTimeout(int initConnTimeoutValue) (Optional)

  Sets the initConnTimeoutValue . The call automatically ends if the opposite peer fails to join the call in initConnTimeoutValue seconds. Default is 60 Seconds (1 Minute). Input values can range between 60 Seconds (1 Minute) and 300 Seconds (5 Minutes)

• skipTermsAndConditionsScreen() (Optional)

  Skips the Terms And Conditions Screen. By Default, a basic Terms And Conditions Screen is included in the flow. If setTermsAndConditionsUrl is used its value is ignored.

• skipInstructionScreen() (Optional)

  Skips the Instruction Screen. By Default, a basic instruction screen is included in the flow.

For any queries/feedback , contact us at support@frslabs.com